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PREFACE 


The X Window System Reference Manual provides manual pages for each Xlib function and manual pages 
for each X Window command. The manual pages are broken into two sections 


e Section 1: X Window manual pages, and 
e Section 3X: Xlib manual pages. 
Within each section, manual pages are presented in alphabetical order. 


A permuted index is provided to help locate the correct manual page. To use the permuted index, simply 
scan down the middle of the page looking for a keyword of interest on the right side of the blank gutter. 
When you find the keyword you want, read the brief description of the command that makes up the entry. 
If you believe you’ve found the command you were looking for, the far right-hand column provides the 
relevant command page. 


Each manual page is broken down into several parts, each part containing information relevant to using the 
command. An explanation of the manual page sub-headings follows: 


e NAME: Under this heading appear the commands related to a particular manual page. The 
first command name is the command after which the manual page is named. Following the 
command names (after the ‘‘-’’) is a brief description of the commands. 


e SYNTAX: Under this heading appear variations of command syntax. Samples of syntax 
argument order are provided. 


e OPTIONS: Under this heading appear definitions of syntax options. In some cases, specific 
instructions for user input are provided. 


e DESCRIPTION: Under this heading appear descriptions of all commands called out under the 
NAME heading. Any errors that can be generated from use of a specific command are provided 
here also. 


e BUGS: Under this heading appear any known bugs associated with the command. 


e DIAGNOSTICS: Under this heading appear descriptions of error messages introduced under 
the DESCRIPTION heading. 


e SEE ALSO: Under this heading appear related manual pages. Each manual page also refers 
you to the Xlib - C Language X Interface, Protocol Version 11 documentation. This 
documentation is provided on-line and in the X Window System Core documentation package. 


Xlib Description 


The Xlib or X library is the lowest level of programming interface to the X Window System. It is powerful 
enough to write effective applications without additional programming tools, and is necessary even with 
the toolkit. The X Toolkit simplifies the process considerably, providing a number of widgets (an object 
providing a user-interface abstraction; for example, a scroll bar) that implement menus, command buttons, 
and other common features of the user interface. Xlib and the X Toolkit should be used together in 
virtually all applications. 


Briefly, the X Toolkit is a user-interface library package that is layered on top of the X Window System. 
The X Toolkit provides tools that simplify the design of application user interfaces in the X programming 
environment. It assists application programmers by providing a commonly used set of underlying user- 
interface functions that enable you to manage widgets, standard operations, toolkit initialization, memory, 
input and events, widget geometry, input focus, selections, resources and resource conversion, translation 
of events, graphics contexts, pixmaps, and errors. (For more information on the X Toolkit, refer to the X 
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Toolkit Library - C Language Interface in the core documentation package). 


Xlib is a C subroutine library that application programs (clients) use to interface with the window system 
by means of a stream connection. Although a client usually runs on the same machine as the X server it is 
talking to, this need not be the case. 


Most of the functions in Xlib just add requests to an output buffer. These requests later execute 
asynchronously on the X server, often referred to as display server. Functions that return values of 
information stored in the server do not return (that is, they ““block’’) until an explicit reply is received or an 
error occurs. If a nonblocking call results in an error, the error will generally not be reported by a call to an 
optional error handler until some later blocking call is made. 


Many Xlib functions will return an integer resource ID, which allows you to refer to eek stored on the 
X server. These can be of type Window, Font, Pixmap, Cursor, and GContext, as defined in a file. These 
resources are created by user requests, and destroyed (or freed) by user requests or when connections are 
closed. Most of these resources are potentially sharable between applications, and in fact, windows are 
manipulated explicitly by window manager programs. Fonts and cursors are typically shared automatically 
since the X server treats fonts specially, loading and unloading font storage as needed. GContexts should 
not be shared between applications. 


As previously stated, Xlib consists of functions. There are several different sets of functions within Xlib. 
Those sets of functions are briefly described here (for more information on the function sets, refer to the 
Xlib - C Language X Interface, Protocol Version 1] on-line or core documentation). 


e Xlib window functions allow you to: create windows; destroy windows; map windows; unmap 
windows; configure windows; change the stacking order; change the window attributes; and 
translate window coordinates. 


Xlib window information functions allow you to: obtain information about a window; 
manipulate property lists; obtain and change window properties; and manipulate window 
selection. 


Xlib graphics resource functions allow you to: manipulate the colormap; manipulate 
pixmaps; manipulate graphics context/state; and use GC convenience routines. 


Xlib graphics functions allow you to: clear and copy areas; draw points, lines, rectangles, and 
arcs; manipulate fonts; draw text characters; transfer images between clients and server; and 
manipulate cursors. 


Xlib window manager functions allow you to: change the parent of a window; control the 
lifetime of a window; manipulate the colormap; manipulate the pointer; manipulate the 
keyboard; grab the server; control processing; manipulate the keyboard encoding; manipulate 
the screen saver; and control host access. 


Xlib events and event-handling functions allow you to: select events; handle the output 
buffer and the event queue; select events from the event queue; send and get events; and handle 
error events. 


Xlib predefined property functions allow you to: communicate with window managers; and 
manipulate standard colormaps. 


Xlib application. utility functions allow you to: handle keyboard events; obtain the X 
environment defaults; parse the window geometry; parse the hardware colors; generate regions; 
manipulate regions; use the cut and paste buffers; determine the appropriate visual; manipulate 
images; manipulate bitmaps; use the resource manager; and use the context manager. 
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Naming Conventions within Xlib 


Throughout Xlib, a number of conventions for naming and syntax of the Xlib functions have been 
followed. These conventions are intended to make the syntax of the functions more predictable, given that 
you remember what information the routine may require. 


The major naming conventions are: 


e The library uses mixed case for external symbols, and leaves lower case for variables and all 
upper case for user macros. This distinction helps to better differentiate the X symbols from the 
user symbols. 


e All Xlib functions begin with a capital X. 
e The beginnings of all procedure names and symbols are capitalized. 


e All user-visible data structures begin with a capital X. More generally, anything that a user 
might dereference begins with a capital X. 


e Macros and other symbols do not begin with a capital X. To distinguish them from all user 
symbols, each word in the macro is capitalized. 


e All elements of or variables in a data structure are in lower case. Compound words, where 
needed, are constructed with underscores (_ ). 


e Global symbols in this manual are printed in this font. These can be either procedure names, 
symbols defined in include files, or structure names. 


There are also conventions for argument order. These conventions are: 
e The display argument, where used, is always first in the argument list. 


e All resource objects, where used, occur at the beginning of the argument list, immediately after 
the display variable. 


e When a graphics context is present together with another type of resource (most commonly, a 
drawable), the graphics context occurs in the argument list after the other resource. Drawables| 
outrank all other resources. 


e Source arguments always precede the destination arguments in the argument list. 


e The x argument always precedes the y argument in the argument list. The width argument 
always precedes the height argument in the argument list. 


e Where the x, y, width, and height arguments are used together, the x and y arguments always 
precede the width and height arguments. 


e Where an array occurs in an argument list accompanied with a count (number of elements in the 
array), the array always precedes the count in the argument list. 


e Where a mask is accompanied with a structure, the mask always precedes the pointer to the 
structure in the argument list. 


e Arguments, user-supplied variables, are printed in italics. 


e To eliminate any ambiguity between those arguments that you pass and those that a function 
returns to you, the explanations for all arguments that you pass start with the word ‘‘specifies.’’ 
By contrast, the explanations for all arguments that are returned to you, start with the word 
“‘returns.”’ 


PERMUTED INDEX 


xclock: analog 
puzzle: 
XDisableAccessControl: control host 
xhost: server 
XAllocColorCells, XAllocColorPlanes, XFreeColors: 
xclock: 
ico: 
XDrawArc, XDrawArcs: draw 
XFillArc, XFillArcs: fill rectangles, polygons, or 
XCopyArea, XCopyPlane: copy 
XPointinRegion, XRectInRegion: region 
XSetCommand: set command 
XIntemAtom, XGetAtomName: create and return 
XGetGeometry: get current window 
XSet WindowBorderPixmap: change window 
xload: load 
XEventsQueued, XPending, XNextEvent, XPeekEvent: 


bitmap: 
XCreateBitmapFromData: manipulate 
XRotateBuffers: manipulate cut and paste 
xcalc: scienufic 
XChangeSaveSet, X AddToSaveSet, XRemoveFromSaveSet: 
/XSetWindowBorder, XSetWindowBorderPixmap: 
/XDeleteProperty: obtain and 
/XCirculateSubwindowsDown, XRestack Windows: 
XDrawString, XDrawString16: draw text 
XIfEvent, XCheckIfEvent, XPeekIfEvent: 
XSetClassHint, XGetClassHint: set or get 
XClearArea, XClearWindow: 
XFree, XNoOp: free 
XSetCloseDownMode, XKillClient: control 
XAddToSaveSet, XRemoveFromSaveSet: change a 
xclock: analog / digital 
XGeometry, XParseColor: parse window geometry and 
XQueryColor, XQueryColors, XLookupColor: obtain 
XSetWindowColormap: create, copy, or destroy 
XListinstalledColormaps: install 
XGetStandardColormap: set or get standard 
XAllocColorPlanes, XFreeColors: allocate and free 
XStoreColors, XStoreColor, XStoreNamedColor: set 
XSetCommand: set 
initialize the Resource Manager and parse the 
XQueryTextExtents, XQueryTextExtents 16: 
XTextWidth, XTextWidth 16: 
XMoveResizeWindow, XSetWindowBorderWidth: 
XOpenDisplay, XCloseDisplay, XNoOp: 
XDeleteContext, XUniqueContext: manipulate the 
XChangeGC, XFreeGC: create and free graphics 
XAllowEvents: 
XSetCloseDownMode, XKillClient: 
XEnableAccessControl, XDisableAccessControl: 
XSetInputFocus, XGetInputFocus: 
XWarpPointer: 
XChangePointerControl, XGetPointerControl: 
xhost: server access 
XSetSubwindowMode, XSetGraphicsExposure: GC 
XSetClipMask, XSetClipRectangles: GC 
XSetFillStyle, XSetFillRule: GC 
XSetFont: GC 
XSetLineAttribute, XSetDashes: GC 
XSetPlanemask, XSetForeground, XSetBackground: GC 
XSetTile, XSetStipple, XSetTSOrigin: GC 
XKeycodeToKeysym, XKeysymToKeycode: 
x10tox11: X version 10 to version 11 protocol 
XQueryPointer: get pointer 
XTranslateCoordinates: translate window 
XCopyArea, XCopyPlane: 
XFreeColormap, XSetWindowColormap: create, 
XCreatePixmap, XFreePixmap: 
XCreateRegion, XSetRegion, XDestroyRegion: 
XCreateGC, XCopyGC, XChangeGC, XFreeGC: 


INTEGRATED SOLUTIONS 


/digital clockforX. ..... suis reach tee tes te td Sey eh xclock(1) 
15-puzzle game forX. ...... & cae & . +. . puzzie(1) 

access. /XSetAccessControl, XEnableAccessControl, . » « « XAddHost(3X) 
access control program for X. . . . oe «© © © «© » 6 Xhost(1) 

allocate and free colors. IKAllocNamedColor, soy 18h ei ee te fe XAllocColor(3X) 
analog / digital clock forX. . . oe ee ee @ © 6XClock(1) 
animate an icosahedron or other polyhedron, a eee ee a ce cot) 

arcs. ee Sz hed Wr Latei Se mas Wah: pk el ies ee winke! VBS S8r ter tes Tee ar ee XDrawArc(3X) 
arcs. /XFillRectangles, XFillPolygon, ee eee eee XFillRectangle(3X) 
@MCAS, sb eee eo a ke Wwe eS on wh ES ee XCopyArea(3X) 
arithmetic. Sia isk: XShrinkRegion, . + « « « © « XIntersectRegion(3X) 


atom. . . 2 2 : ee ee ew ew ww we ww ew + ~XSCHCOmmand(3X) 

atom names. . . 1. 6 + ee ee ee en ee: atte: Pate XInternAtom(3X) 

attribute or geometry. XGetWindowAttributes, ...... XGetWindowAttributes(3X) 
attributes. /XSetWindowBorder, ...... . . . . XChangeWindowAttributes(3X) 
average display forX. ........-. tia) ne ceaanval ok xload(1) 

basic error handling. XFlush, XSync, xe We. Geis arts XFlush(3X) 

bitmap: bitmap editorforX. . 2... 6 6 2 2 ee ewe bitmap(1) 

bitmap editor forX. . 2. 6. 2 2 eee ee ee . . . bitmap(1) 

bitmaps. /XCreatePixmapFromBitmapData, . XReadBitmapFile(3X) 


buffers. /XStoreBuffer, XFetchBytes, XFetchBuffer, 


. XStoreBytes(3X) 


calculatorforX. ......6- Soe Be, I . es . xcale(1) 

change a client’s save set. ..... ‘ at hice 8 XChangeSaveSet(3X) 
change window attributes. . 2... 1.62.2 se ee eee XChangeWindowAttributes(3X) 
change window properties. . ....... oe 6 6 «© « « XGetWindowProperty(3X) 
change window stacking order. ...... 2. . . XRaiseWindow(3X) 
characters. . 6. 6 we ee ew we we we ew wh ww ww we  6XDrawstring(3X) 
check the eventqueue. . 2... 2. 2 eee ee ee ene XIfEvent(3X) 

classhint . 2... ..-2. 2 ees percep Te sean wei! oo Nie ais ots XSetClassHint(3X) 

clear windows. iy 2S: Reh igh Oe Oe. eats ae + + « « « « XClearArea(3X) 

client dataa .....24.. ed Ginter wise, eet . « « « XFree(3X) 

clients. .... see eww ee we we we we ww ew 6 KSCHClOSCDOwnMode(3X) 
client’s save set. XChangeSaveSet, é, . . « XChangeSaveSet(3X) 
clock forX. ...... ; . « xclock(1) 


color. XParseGeometry, ......... 


. 
. 
ee e e © e@ © @ 28 @ 
e 
. 


. XParseGeometry(3X) 


colorvalues.; ....-2. 2.2 ee eee - . « XQueryColor(3X) 
colormaps. /XCopyColormapAndFree, XFreeColormap, - . » XCreateColormap(3X) 
colormaps. XInstallColormap, XUninstallColormap, .. . . XInstallColormap(3X) 
colormaps. XSetStandardColormap, ......... . . XSetStandardColormap(3X) 
colors. /XAllocNamedColor, XAllocColorCells, . ... . . XAllocColor(3X) 

COOLS 3: ioe 6 oi te tele a ee as wee oe 6 © © © © 6 XStoreColors(3X) 
command atom. . . e+ » » &SCtCommand(3X) 
command line. Xnmlnitialize, Xan PhescCommand:: ee ee eae XrmlInitialize(3X) 
compute or query text extents. /XTextExtents16, ...... XTextExtents(3X) 
compute text widthh . ...... Suet, sts cael case. caine 6h XTextWidth(3X) 
configure windows. /XMoveWindow, XResizeWindow, .. . XConfigureWindow(3X) 
connect or disconnect to X server. . .. 2.2.20 - « « « XOpenDisplay(3X) 
context manager. XSaveContext, XFindContext, .... . . XSaveContext(3X) 
contexts. XCreateGC, XCopyGC, .... 2... ee eee XCreateGC(3X) 

continue frozen event processing. . .-. - +. e+ eee e XAllowEvents(3X) 
control clients. . 2... 6 1 2 ee ew ee se 6 « « « XSetCloseDownMode(3X) 
control host access. /XSetAccessControl, .... . » . » « XAddHost(3X) 

control input focus. 2... 2. 1 6 ee we ee ew . XSetinputFocus(3X) 
controlinput focus. . 2... 6 1 6 we ee ee ee ew XWarpPointer(3X) 
control pointer, . 6 6 6 6 eee we we te ee tt XChangePointerControl(3X) 
control program for X. site Me See ek var Ven esse . » » » Xhost(1) 

convenience routines. XSetArcMode, ......4.e++6-s XSetArcMode(3X) 
convenience routines. XSetClipOrigin, .......4.4.. XSetClipOriginGX) 
convenience routines. . 2. 6 2 0 ee ew ew ew te te es XSetFillStyle(3X) 
convenience routines. . .. 1... ‘ . + « © » XSetFont(3X) 
convenience routines. . . 1... 2 eee ee «+ « © « «© XSetLineAttribute(3X) 
convenience routines. XSetState, eS b, Bo cent ie - XSetState(3X) 
convenience routines. . 2... 6 6 eee ee eee . » « XSetTile(3X) 


converter. 
coordinates, 
coordinates. 
copy areas. 


« 28 © © e@© © © © © &® 8 © @ 


copy, or destroy colormaps. /XCopyColormapAndFree, . . 


create and destroy pixmaps. 
create and destroy regions. ..... 
create and free graphics contexts. 


oo e¢ ee ee e © ee e# @ 


- Vii - 


. XStringToKeysym(3X) 

- x10tox11(1) 

- XQueryPointer(3X) 
XTranslateCoordinates(3X) 


XCopyArea(3X) 


. XCreateColormap(3X) 
. XCreatePixmap(3X) 
. XCreateRegion(3X) 
. XCreateGC(3X) 
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Permuted Index 


XIntemAtom, XGetAtomN: aie’ 


/X¥FreeColormap, XSetWindowColormap: 
XCreatePixmapCursor, XCreateGlyphCursor: 
XCreate Window, XCreateSimple Window: 
XGetWindowAttributes, XGetGeometry: get 
XCreatePixmapCursor, XCreateGlyphCursor: create 
XDefineCursor, XUndefineCursor: define 
XFreeCursor, XQuery BestCursor: manipulate 
XFetchBuffer, XRotateBuffers: manipulate 

XFree, XNoOp: free client 
XrmQPutStringResource, XrmPutLineResource: store 
/XrmQGetSearchList, XrmQGetSearchResource: retrieve 
xrdb: X server resource 

XrmGetStringDatabase: manipulate resource 
XDisplayName, XSetIOErrorHandler: 

XGetDefault: get X program 

XDefineCursor, XUndefineCursor: 
XFreeColormap, XSetWindowColormap: create, copy, or 
XCreatePixmap, XFreePixmap: create and 
XSetRegion, XDestroyRegion: create and 

XDestroy Window, XDestroySubwindows: 

XQuery BestSize, XQueryBestTile, XQueryBestStipple: 
XEmptyRegion, XEqualRegion: 
xclock: analog / 

xdpr: dump an.X window 
XSynchronize, XSetAfterFunction: enable or 
XOpenDisplay, XCloseDisplay, XNoOp: connect or 
xload: load average 

xfd: font 

xlsfonts: server font list 

xprop: property 

xwud; image 

XDrawArc, XDrawArcs: 

XDrawiiageString, XDrawImageString 16: 
XDrawLine, XDrawLines, XDrawSegments: 
XDrawPoint, XDrawPoints: 

XDrawText, XDrawText16: 

XDrawRectangle, XDrawRectangles: 

XDrawString, XDrawString16: 

muncher: 

xpr: print an X window 

xwd: 

xdpr: 

bitmap: bitmap 

xedit: simple text 

XQueryBestTile, XQueryBestStipple: determine 
XEqualRegion: determine if regions are 

xterm: terminal 

XSynchronize, XSetA fterFunction: 
XEqualRegion: determine if regions are empty or 
XDisplayName, XSetIOErrorHandler: default 
XPending, XNextEvent, XPeekEvent: basic 
XAllowEvents: continue frozen 

XIfEvent, XCheckIfEvent, XPeekIfEvent: check the 
XGetMotionEvents, XSendEvent: select 
_XLookupString, ahaha eySy a handle keyboard input 
XSelectinput: select input 

XPutBackEvent: put 

XQueryTextExtents 16: compute or query text 
/XFillRectangles, XFillPolygon, XFillArc, XFillArcs: 
xbiff: mailbox 

XSetInputFocus, XGetInputFocus: control input 
XWarpPointer: control input 

xfd: 
xlsfonts: server 

XListFonts, XFreeFontNames: obtain and free 
XGetFontPath, XFreeFontPath: set, get, or free the 
XUnloadFont, XGContextFromGC: manipulate 
XFree, XNoOp: 

XAllocColorPlanes, XFreeColors: allocate and 
XListFonts, XFreeFontNames: obtain and 
XCreateGC, XCopyGC, XChangeGC, XFreeGC: create and 
XGetFontPath, XFreeFontPath: set, get, or 
XAllowEvents: continue 

puzzle: 15-puzzle 

XSetSubwindowMode, XSetGraphicsExposure: 
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create and retum atom mames. . . 2... 6.6 ee se eee XInternAtom(3X) 
create, copy, or destroy colormaps. ....... oo « « « « XCreateColormap(3X) 
create cursors. XCreateFontCursor, ... 2... see ee XCreateFontCursor(3X° 
create windows. ..... St teh ev eh ahs set ah ren Seg ee? ve XCreate Window(3X) 
current window attribute or geometry. ..... 2... XGetWindowAttributes 
cursors. XCreateFontCursor, wee ee wee ow ow we © 6 XCreateFontCursor(3X; 
cursors. .....- 28018 caf cee Ye Bea ecaes Ta eh te ale™ Bees XDefineCursor(3X) 
cursors. XRecolorCursor, ..... 2. ee eee « « » « XRecolorCursor(3X) 
cut and paste buffers. /XStoreBuffer, XFetchBytes, .... . XStoreBytes(3X) 

atas 55 senso ie, So tar este sas Ser Seat 2 es “is, 4S We te foc ah eet ee XFree(3X) 

database resources, /XrmPutStringResource, ....... XrmPutResource(3X) 
database resources and search lists. ovat we esiei Bee Bee XrmGetResource(3X) 
databaseutiliy. 1... 6. ee ee ee we ee ew ene xrdb(1) 

databases. /XrmGetFileDatabase, XrmmPutFileDatabase, . . . XmnMergeDatabases(33 
default error handlers. /XGetErrorDatabaseText, ... . . . XSetErrorHandler(3X) 
defaults. pre RE a ee day eee ee 
define cursors. . 2 1. 2 ee ee ee we ee we ww oe we 6 MDOfineCursor(3X) 
destroy colormaps. /XCopyColormapAndFree, . . . . . . . XCreateColormap(3X) 
destroy pixmaps. oe oe ee ee ww ew ww oe oe 6 XCreatePixmap(3X) 
destroy regions. XCreateRegion, atlas, Vath tial SRL ate A ES, XCreateRegion(3X) 
destroy windows. ..... &: Mi enne’ Mee Se 5 . . - » » XDestroyWindow(3X) 
determine efficient sizes. . . 2. 2 6 es ee eee ew - XQueryBestSize(3X) 
determine if regions areempty orequal. . . ... 2... 6 XEmptyRegion(3X) 
digital clock forX. .......6-.- hota te 08:82 Bee - « xclock(1) 
directly to the printer, . 2. 1 6 6 6 + ee ew ee ee oe © 6 XOprl) 

disable synchronization. . . 2... 2.2.2 ee - s+ « « » XSynchronize(3X) 


disconnect to X server. 


. XOpenDisplay(3X) 


display forX. .... 2.56. ee ee . . - xload(1) 
displayerforX. . 2... 2 2 ee eee we we we ewe xfd(1) 
displayerforX. ...... iia: ae ee A ee ae ° . Xlsfonts(1) 
displayerforX. ..... ae oe ee ee ‘. - xXprop(1) 
displayerforX. 2. 2 2 2 ee we ww ee ee ewe we xwud(1) 
drawarcs. 1... 2. 2 ee : ee eee ‘ .» XDrawArc(3X) 


draw image text. . 2. 6 2 1 ee ew ew ee ww . » XDrawlImageString(3X) 
draw lines and polygons. . ....... : » «+» + XDrawLine(3X) 
draw points. ...... Sole hh et Sr danter te oe ee © © © XDrawPoint(3X) 
draw polytexttext. 2 2 ee ee ee ee ee ee . » XDrawText(3X) 
draw rectangles. . 2. 1 2 ee we ee eee ee ee ee XDrawRectangle(3X) 
draw text characters, . 2. 2. 2. 2 2 ee ee Bue cele . XDrawString3X) 
draws interesting pattems in an X window. ....... - muncher(1) 

GUM: ie 5 Sos eh te eo SN a Se ah Se eh Gig, ee PTE) 
dump an image of an X window: Sb ees See Gee Tarte . . . xwd(1) 

dump an X window directly to the printer. . ........ xdpr(1) 

editorforX. . 6... 0 ee ee Bm etsy ta ae are bitmap(1) 
editorforX. ...... bel gvace caudate, oie ora de HEHE) 

efficient sizes. XQueryBestSize, of St oes «2 e « « « XQueryBestSize(3X) 
empty orequal. XEmptyRegion, .......... . . XEmptyRegion(3X) 
emulatorforX. «2. 6 6 eee ee ee oe we ow ow we se Xterm(l) 

enable or disable Synchronization: ata) Ye torcharl aio S: wc tet te" eelnzs XSynchronize(3X) 
equal. XEmptyRegion, .. ...... ++... + XEmptyRegion(3X) 
error handlers. /XGetErrorDatabaseText, .... . . . . . XSetErrorHandler(3X) 
error handling. XFlush, XSync, XBventsQueued, Steeles ay . XFlush(3X) 

event processing. ....... oe ee ew we ww oe © © 6 XAllowEvents(3X) 
event queue. Sucks coun ei os ferleh eh seeder wpe ee aune . . XIfEventGX) 

event types. /XCheckTypedWindowEvent, ‘ . » « « XWindowEvent(3X) 
events. XLookupKeysym, XRefreshKeyboardMapping, . . « XLookupKeysym(3X) 
events. 2 6 6 ee ee te hw hw ew ew ew we ew wo ew 6 MSClCCtInput(3X) 
events back onthe queue. . . 2... 2 2 6 © «© © © © © © 0 PutBackEvent(3X) 
extents. /XTextExtents16, XQueryTextExtents, .... .. XTextExtents(3X) 
fill rectangles, polygons, or arcs. . . . ........ =.» XFillRectangle(3X) 
Mas tor Ay. sees Sw Sk we we ea ee Se oe eS RDI) 

FOCGS, ce ee ee ee ee ee ew oe » XSetinputFocusGX) 
focus. 2. 2 2 6 6 6 ee oo oe ww ow wo ww oe « ~ KWarpPointer(3X) 
font displayerforX. ...... bia Pare otras fae Jes oP tae xfd(1) 

font list displayerforX. . 2. 2 2 6 ee © © © © © © © © ~ Xisfonts(1) 


font names. 


. XListFonts(3X) 


font search path. XSetFontPath, oe 0 ee eh we ew we ew ee «© 6 XSetFontPath(3X) 
fonts. /XFreeFont, XGetFontProperty, .......+.-. XLoadFont(3X) 
freeclientdata. 1... 2. 2 ee eee ee ewe enone XFree(3X) 
free colors. /XAllocNamedColor, XAllocColorCells, » « « « XAllocColor(3X) 
freefontnames. ...... eee we we ewe oe ee @ & MListFonts(GX) 
free graphics contexts. . 2. 6 2 2s ee ew ee ee ee XCreateGC(3X) 
free the font search path. Cero r ain, oe ee ew ee ee 6MSUtFontPath(3X) 
frozen event processing. ...-°.. as *% . . XAllowEvents(3X) 
gameforX. .....+. - oe ee ew we ee ~6puzzie(l) 
GC convenience routines. XSetArcMode, Sa tu Gh ten : . XSetArcMode(3X) 
- Vili - INTEGRATED SOLUTIONS 


XSetClipOrigin, XSetClipMask, XSetClipRectangles: 
XSetFillStyle, XSetFillRule: 

XSetFont: 

XSetLineAttribute, XSetDashes: 

XSetPlanemask, XSetForeground, XSetBackground: 
XSetTile, XSetStipple, XSetTSOrigin: 
XPolygonRegion, XClipBox: 

XGetGeometry: get current window attribute or 

XGeometry, XParseColor: parse window 

XCopyGC, XChangeGC, XFreeGC: create and free 
/XLookupString, XRebindKeySym: 

xmh: X window interface to the mh Mail 

XDisplayName, XSetIOErrorHandler: default error 

XPending, XNextEvent, XPeekEvent: basic error 

XSetClassHint, XGetClassHint: set or get class 

XGetTransientForHint: set or get transient for 

XSetIconSizes, XGetIconSizes: set or get icon size 

XGetNormalHints: set or get normal state 

XGetSizeHints: set or get window size 

XSetWMHints, XGetWMHints: set or get window manager 

XSetZoomHints, XGetZoomHints: set or get zoom state 

XDisableAccessControl: control 


XSetIconName, XGetIconName: set or get 
XSetlconSizes, XGetIconSizes: set or get 

ico: animate an 

XEmptyRegion, XEqualRegion: determine 

xwud: 

xwd: dump an 

XDrawImageString, XDrawImageString 16: draw 
XPutPixel, XSubImage, XAddPixel, XDestroyImage: 


XPutlmage, XGetImage, XGetSubImage: transfer i 
XGetVisualInfo, XMatchVisualInfo: obtain visual i 
XQueryTree: query window tree i 


xwininfo: window 
command line. Xrmlnitialize, XrmParseCommand: 
xinit: X Window System 
XLookupString, XRebindKeySym: handle keyboard 
XSelectinput: select 
XSetInputFocus, XGetInputFocus: control 
XWarpPointer: control 
XUninstallColormap, XListInstalledColormaps: 
muncher: draws 
xmh: X window 
XGrabKey, XUngrabKey: manipulate the 
XGrabKeyboard, XUngrabKeyboard: manipulate the 
XGrabServer, XUngrabServer: manipulate the 
XLookupString, XRebindKeySym: handle 
xmodmap, xprkbd: 
xmodmap, xprkbd: 
XAutoRepeatOff, XBell, XQueryKeymap: manipulate 
XKeycodeToKeysym, XKeysymToKeycode: convert 
the Resource Manager and parse the command 
XDrawLine, XDrawLines, XDrawSegments: draw 
xlsfonts: server font 
retrieve database resources and search 
xload: 
xlogo: X Window System 
~xmh: X window interface to the mh 
xbiff: 
wm: a simple real-estate-driven window 
XUniqueContext: manipulate the context 
XrmParseCommand: initialize the Resource 
, uwm: a window 
twm - a window 
XSetWMHints, XGetWMHints: set or get window 
XSetStandardProperties: set standard window 
XCreatePixmapFromBitmapData, XCreateBitmapFromData: 
XRecolorCursor, XFreeCursor, XQueryBestCursor: 
XFetchBytes, XFetchBuffer, XRotateBuffers: 
XGetFontProperty, XUnloadFont, XGContextFromGC: 
‘  XAutoRepeatOff, XBell, XQueryKeymap: 
XSetPointerMapping, XGetPointerMapping: 
XrmPutFileDatabase, XrmGetString Database: 
XmmStringToQuarkList, XmmStringToBindingQuarkList: 
XFindContext, XDeleteContext, XUniqueContext: 


INTEGRATED SOLUTIONS 


Permuted Index 


GC convenience routines. . . . 


GC convenience routines. ...... Bi Siena foley ei <g? 
GC convenience routines. . 2... 6 2 se se eee oe 
GC convenience routines. .....-. eo Letee 
GC convenience routines. XSetState, XSetFunction, ee ust day 
GC convenience routines. . . 2. 2 6 ee we ew ‘ 
generate regions. .... Si, Gi) eee. Sexe 
geometry. XGetWindowAttributes, od Ge eset eter ot Deas Sia 


geometry and color. XParseGeometry, .........-. 
graphics contexts. XCreateGC, 
handle keyboard input events. 


XSetClipOrigin(3X) 
XSetFillStyle(3X) 
XSetFont(3X) 
XSetLineAttribute(X) 
XSetState(3X) 


. « XSetTileX) 
. XPolygonRegion(3X) 


XGetWindowAttributes(3X) 
XParseGeometry(3X) 


. XCreateGC(3X) 
. XLookupKeysym(3X) 


Handler... cco: se. 00 do 0h, Mo ie Me Se ew rds - xmh(1) 
handlers. /XGetErrorText, XGetErrorDatabaseText, oe eese} 2% XSetErrorHandler(3X) 
handling. XFlush, XSync, XEventsQueued, . ....... XFlush(3X) 
DiGi: xp, eeio5 286,430 See's ideas Se aces Sek Eee «+ « © « « XSetClassHint(3X) 
hint. XSetTransientForHint, b neinel e Lemme: id veto er ee fo 8 . XSetTransientForHint(3X) 
WARES. is esis he few Sa we ee a ae ee ee . XSetIconSizeHints(3X) 
hints. XSetNormalHints, ...... ee ae . « « XSetNormalHints(3X) 
hints. XSetSizeHints, ......... ge Salve: ghey, Gar oe XSetSizeHints(3X) 
HANES e=* 6Gt Sah 12S: ene @ ser Gow, Ee wR St Birds + © » » XSetWMHints(3X) 
Fists: | ees Xa> ee Se acne oh tere ios eh Si, Sizea Rae ca oe Oem. XSetZoomHints(3X) 
host access. /XEnable AccessControl, ee ee ae ee XAddHost(3X) 
ico: animate an icosahedron or other polyhedron. .... . . ico(1) 
iconnames. .... 2.5626 ee ee . aos’ aes G6, atte Me XSetlconName(3X) 
ICOM SIZE. MINIS; vs) o:- 66 Nera is! Bh ae te. SS ee. ees) XSetlconSizeHints(3X) 
icosahedron or other polyhedron. . .....+. +... ico(l) 
if regions areempty orequal. . ...... +... .. XEmptyRegion(3X) 
image displayerforX. ..... Si Mates on bla A ee eA xwud(1) 
image of an X window. .......2.-. Ruivigs aio pe cares xwd(1) 
IMAPE TER 5 Boe wes Eee Sas Be Se! Bw a XDrawlImageString(3X) 
image utilities. XCreatelmage, XGetPixel, .......-. XCreateImage(3X) 
imMAgeSs. 6 6 vw ew be we 8 ee ee by es dee TAS, eset Ses 98 XPutlmage(3X) 
mionnahon. 2.66 de ive BS her eg el OS Ga XGetVisualInfo(3X) 
information. . .. 1... 6 ee ee siege teens . . « « XQueryTree(3X) 
information utility forX. ...... se ee ee ew ee ©) 6XWininfo(1) 
initialize the Resource Manager and parse the - 6 ee « ~~ Xrmlinitialize(3X) 
IMMA ZET 0 oS. Re Ryall Se ew ee WE erat RELY 
input events. /XRefreshKeyboardMapping, ..... . . . XLookupKeysym(3X) 
inputevents. ......... ee wee ee ee © 6 XSelectinput(3X) 
input focus. 2. 6. 6 6 6 wwe we ee ee ew ew we ew © 6XSCtINputFocus(3X) 
input focus, . 2. 6 6 6 ee ee we we ww ee © © ~XWarpPointer(3X) 
install colormaps. XInstallColormap, ....... +.» XInstallColormap(3X) 
interesting pattems in an X window. ...... .. . ~~ muncher(1) 

xmh(1) 


interface to the mh Mail Handler. .......062- : 


. XGrabKey(3X) 


keyboard. ..... aie e Tee Peet Ar les a8, eee - XGrabKeyboard(3X) 
keyboard. ......-+ee6-. ae « XGrabServer(3X) 
keyboard input events. /XRefreshKeyboardMapping, - - . « XLookupKeysym(3X) 
keyboard modifier utilities forX.  . ....... =... + xmodmap(1) 
keyboard modifier utilities forX. ..... oe ee ee © Xprkbd(1) 
keyboard settings. /XAutoRepeatOn, . . . ... .. . . » XChangeKeyboardControl(3X) 
keysyms. XSturingToKeysym, XKeysymToString, ..... XStringToKeysym(3X) 
line. XrmlInitialize, XrmParseCommand: initialize ..... Xnmlnitialize(3X) 
lines and polygons. . 2. 6 0s ee eet ee we ew a XDrawLine(3X) 
list displayerforX. 2 2 1 1 6 ww we ww ee ew te xisfonts(1) 
lists. /XrmQGetSearchList, XnnQGetSearchResource: . XrmGetResource(3X) 
load average display forX. ..... ge ii bee GS xload(1) 
MOBOs> > e525. 2. 16s oe SR 2S ee at Sa a, & es xlogo(1) 
Mail Handler. . .... 2.2. ¥ ss 3c “elie a ta se xmh(1) 
mailbox flagforX. . 2... 22 wee oa ae ae . xbiff(1) 
MANARET.: ocd eR Se we ae we oe ee e wml 
manager. /XFindContext, XDeleteContext, rae ae eae XSaveContext(3X) 
Manager and parse the command line. XrmlInitializ, .. . . Xrmlinitialize(3X) 
managerforX. .... . oe ee ew ew ee 6UUWM()) 
manager for X11 (Tom’ $ Window Manager oe eo ee»  twm(l) 
manager hints. we ee ee te we we we ew we KCLWMHints(3X) 
manager properties. ...... Ea ar ae ee oe ae oa XSetStandardProperties(3X) 
manipulate bitmaps. /XWriteBitmapFile, + 2 6 « «© © © «© « XReadBitmapFile(3X) 
manipulate cursors. . 2... 1 ee wee ee ee www XRecolorCursor(3X) 
manipulate cut and paste buffers. /XStoreBuffer, Sindee tes sa Seu’ XStoreBytes(3X) 
manipulate fonts. /XLoadQueryFont, XFreeFont, . .. . . . XLoadFont(3X) 
manipulate keyboard settings. /KAutoRepeatOn, ... . . . XChangeKeyboardControl(3X) 
manipulate pointer settings. ..... - » - « « XSetPointerMapping(3X) 
manipulate resource databases. [XtmGetFileDatabase, ‘ - XrmMergeDatabases(3X) 
manipulate resource quarks. /KrmQuarkToString, . . » XrmUniqueQuark(3X) 
manipulate the context manager. XSaveContext, ...... XSaveContext(3X) 
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Permuted Index 


XGrabKey, XUngrabKey: 
XGrabKeyboard, X UngrabKeyboard: 
XGrabServer, XUngrabServer: 
XGrabButton, XUngrabButton: 
XUngrabPointer, XChangeActivePointerGrab: 
XResetScreenSaver, XGetScreenSaver: 
XGetSelectionOwner, XConvertSelection: 
xmh: X window interface to the 
xmodmap, xprkbd: keyboard 
xmodmap, xprkbd: keyboard 


XInternAtom, XGetAtomName: create and retum atom 

XListFonts, XFreeFontNames: obtain and free font 

XSetIlconName, XGetIconName: set or get icon 

XStoreName, XFetchName: set or get window 

X - a portable, 

XSetNormalHints, XGetNormalHints: set or get 

/XRotateWindowProperties, XDeleteProperty: 

XListFonts, XFreeFontNames: 

XQueryColor, XQueryColors, XLookupColor: 

XGetVisualInfo, XMatchVisualInfo: 

XRestack Windows: change window stacking 
plaid: 

xsetroot: root window 

initialize the Resource Manager and 
XParseGeometry, XGeometry, XParseColor: 

XFetchBuffer, XRotateBuffers: manipulate cut and 

XFreeFontPath: set, get, or free the font search 

muncher: draws interesting 

plaid: paints some plaid-like 

XCreatePixmap, XFreePixmap: create and destroy 
window. 

plaid: paints some 

XChangePointerControl, XGetPointerControl: control 

XGrabButton, XUngrabButton: manipulate the 

XChangeActivePointerGrab: manipulate the 

XQueryPointer: get 

XSetPointerMapping, XGetPointerMapping: manipulate 
XDrawPoint, XDrawPoints: draw 

XDrawLines, XDrawSegments: draw lines and 
XFillPolygon, XFillArc, XFillArcs: fill rectangles, 

ico: animate an icosahedron or other 

XDrawText, XDrawText16: draw 

X-a 

xset: user 

Xxpr: 

xdpr: dump an X window directly to the 
XAllowEvents: continue frozen event 
XGetDefault: get X 

xhost: server access control 

XDeleteProperty: obtain and change window 

XSetStandardProperties: set standard window manager 
xprop: 

x10tox11: X version 10 to version 11 
XPutBackEvent: 


XmmStringToBindingQuark List: manipulate resource 
XQueryTextExtents, XQueryTextExtents 16: compute or 
XQueryTree: 

XChecklfEvent, XPeeklIfEvent: check the event 
XPutBackEvent: put events back on the 

wm: a simple 

XDrawRectangle, XDrawRectangles: draw 
XFillPolygon, XFillArc, XFillArcs: fill 

xrefresh: 

XShrinkRegion, XPointInRegion, XRectInRegion: 
XSetRegion, XDestroyRegion: create and destroy 
XPolygonRegion, XClipBox: generate 
XEmptyRegion, XEqualRegion: determine if 
XReparentWindow: 
xrdb: X server 

XrmGetString Database: manipulate 
Xmnlnitialize, XrmParseCommand: initialize the 
XrmStringToBinding QuarkList: manipulate 
XrmPutLineResource: store database 
XrmQGetSearchResource: retrieve database 
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manipulate the keyboard. 
manipulate the keyboard. 
manipulate the keyboard. .. 


. XGrabKey(3X) 
. . XGrabKeyboard(3X) 
. XGrabServer(3X) 


manipulate the pointer. . . oe ee ew ee we © © © 6 XGrabButton(3X) 
manipulate the pointer. XGrabPointer, este - » « « » XGrabPointer(3X) 
manipulate the screen saver. [X ActivateScreenSaver, - e . . XSetScreenSaver(3X) 
manipulate window selection. XSetSelectionOwner, - . « » XSetSelectionOwner(3: 
mh Mail Handler... 1 1 ww we ew ee et we ees xmhf1) 

modifier utilities forX. ..... oe eo © © © © ~~ 6XMOdmap(1) 

modifier utilities forX. ..... rar oe 6 ee © 6Xprkbd(1) 

muncher: draws interesting patterns in an X window. . « + » muncher(1) 

PRATNESS 555% a SS ceed Vets: a foetus foc o8 ar a? eS ayes er Mele XInternAtom(3X) 
MAMES. — 6; 6 6 6 5) ce ia. “ese ee aie. '8 ee ee eae XListFonts(3X) 
names. ......-. wee ee www we we we oe ee 6XSeticonName(3X) 
mames. . 2 1. 1 6 ee ee ee we ee we we ew ew we ew es KSLOrEName(3X) 
network-transparent window system. .... +. .+-+.. X(i) 

normal state hints. =. 6 we we we ee ee ew ww ee 0 NCtNOnmalHints(3X) 
obtain and change window properties. ..... .. + + « XGetWindowProperty(: 
obtain and freefontmames. . .. 2. 2.6 6 se we ee wes XListFonts(3X) 
obtain color values. 2. 2 2 6 2 ee we ee ew he we we XQueryColor(3X) 
obtain visualinformation, ........26-. - . » . . XGetVisualinfo(3X) 
order. /XCirculateSubwindowsDown, ...... ; . XRaiseWindow(3X) 
paints some plaid-like patterns in an X window. ...... plaid(1) 

parameter setting utilityforX. .... oe eo ee © 6XSetroot(]) 

parse the command line. /XrmParseCommand: ao a ee eesie . « Xrminitialize(3X) 
parse window geometry andcolor. . ........4s+e6s XParseGeometry(3X) 
paste buffers. /XStoreBuffer, XFetchBytes, ........ XStoreBytes(3X) 

path. XSetFontPath, XGetFontPath, ........-+e-s XSetFontPath(3X) 
patterns in an X window.  . 2... 2. 2 5 ee ew wee muncher(1) 

patterns in an XX window. . 2... 2.2.2 2 ee ee eee plaid(1) 

pixmaps. ........ Site Gyan Sey vara: ciaies Zao ee gt len . XCreatePixmap(3X) 
plaid: paints some plaid-like pattems inanX ...... . . plaid(1) 

plaid-like patterns in an X window. ...... - «. -  plaid(l) 

pointer, . 6... -- ce eee we we ew ow ew we © © 6 XChangePointerControl 
POINlef,. 6 4k Gar Gass Soe. eV win oe Ss 42S - + « « XGrabButton(3X) 
pointer. XGrabPointer, XUngrabPointer, ee ee © eo © © © ~ XGrabPointer(3X) 
pointer coordinates. . .... 2.226 + + e 6 «© © « XQueryPointer(3X) 
POMUSr SEMIN PS: 4. es daleey Sie es Se we eS a¢SeqPomiber Mapping 
points. ...... ee ee we we ee ww we ww ee 6 MDrawPoint(3X) 
polygons. XDrawLine, ..... 22.2 ee ee eee - XDrawLine(3X) 
polygons, or arcs. /XFillRectangles, .......... . . XFillRectangle(3X) 
i ic er a ca oe ee we ew ical) 

Polytexttext., oe be er ee we es . » « XDrawText(3X) 
portable, network-transparent window system, sin saty Be fels "SVs . X(1) 

preference utility forK. . 2... 20 ee eee eens xset(1) 
printan XX windowdump. ........+.++..s-e-. Xpr(l) 

printer, . 2... 2-1 we ee cee ew ee eh ww fe e XEpr(l) 

PROCESSING: «| ia ac SSS Hee i ee aoe . . XAlowEvents(3X) 
program defaults. cee et hw we we we ew we oe ow MGetDefault(3X) 
prograniior Xo. 6366. cece, asics ew eo we See . » Xhost(1) 

properties. PXRotateWindow Properties, ee ee © © © © XGetWindowProperty(3: 
properties. ... cee ew wh we we we we ww ew ee 6 NCHStandardProperties( 
property displayer for X. wie eT ene oe ew oe ew we ew ee © 6Xprop(l) 

protocol converter. .......-s a ee ee . e « « x10toxi1(1) 

put events back on the queue. . 1... 1 0 wee we ee XPutBackEvent(3X) 
puzzle: 15-puzzle game forX. ..... . + + « puzzle(1) 

quarks. /XrmQuarkToString, XrmStringToQuarkList, . + « » XrmUniqueQuark(3X) 
query text extents. XTextExtents, XTextExtents16, ..... XTextExtents(3X) 
query window tree information. ......... =... . XQueryTree(3X) 
queue. XIfEvent, . 2... 6 2 6 ee ew ee ew we oe 6 MfEVent(3X) 

queue, 6. 6 we we ww ee ee ww wwe ww we © © 6 XPUtBackEvent(3X) 
real-estate-driven window manager. .......... . wm(l) 

rectangles. . 2... 2. oe 8 ee ew ee © © ~~ XDrawRectangle(3X) 
rectangles, polygons, or arcs. /XFillRectangles, - .... . XFillRectangle(3X) 
refresh all or partofan Xscreen, .... 2.25. . +». xrefresh(1) 

region arithmetic. /XXorRegion, XOffsetRegion, . .. . . . XIntersectRegion(3X) 
regions. XCreateRegion, . . . 2... + 6 «© © « «© © « © MCreateRegion(3X) 
fegions. . «2 6 6 we ee we ee th ww ww ww ow es 6 XPOlygonRegion(3X) 
regions areempty orequal. . 2... 2... 2 ee . . . . XEmptyRegion(3X) 
reparent windows. sis are sad erat, tah sare vehnan. We t0) ak le iene wie! Ze XReparentWindow(3X) 
resource database utility. . 2... 6 2s eo ee . . xrdb(1) 

resource databases.. /XrmPutFileDatabase, le . . » XmmMergeDatabases(3 


Resource Manager and parse the commandline. . . 
resource quarks. /XrmStringToQuarkList, ..... 
resources. /XrmQPutStringResource, 
resources and search lists. /XrmQGetSearchList, ...... 


. Xnmlnitialize(3X) 


XrmUniqueQuark(3X) 
XrmPutResource(3X) 
XrmGetResource(3X) 


INTEGRATED SOLUTIONS 


/XrmQGetSearchList, XrmQGetSearchResource: 
XInternAtom, XGetAtomName: create and 

xsetroot: 
XSetGraphicsExposure: GC convenience 
XSetClipMask, XSetClipRectangles: GC convenience 
XSetFillStyle, XSetFillRule: GC convenience 
XSetFont: GC convenience 
XSetLineAttribute, XSetDashes: GC convenience 
XSetForeground, XSetBackground: GC convenience 
XSetTile, XSetStipple, XSetTSOrigin: GC convenience 
XRemoveFromSaveSet: change a client’s 
XGetScreenSaver: manipulate the screen 

xcalc: 
xrefresh: refresh all or part of an X 
XResetScreenSaver, XGetScreenSaver: manipulate the 
retrieve database resources and 
XFreeFontPath: set, get, or free the font 
XGetMotionEvents, XSendEvent: 

XSelectInput: 

XConvertSelection: manipulate window 
XCloseDisplay, XNoOp: connect or disconnect to X 

X - X Window System 

xhost: 

xisfonts: 


xis: 
xrdb: X 
XRemoveFromSaveSet: change a client’s save 
XStoreColors, XStoreColor, XStoreNamedColor: 
XSetCommand: 
XSetFontPath, XGetFontPath, XFreeFontPath: 
XSetClassHint, XGetClassHint: 
XSeticonName, XGetIconName: 
XSetIconSizes, XGetIconSizes: 
XSetNormalHints, XGetNormalHints: 
XSetStandardColormap, XGetStandardColormap: 
XSetTransientForHint, XGetTransientForHint: 
XSetWMHints, XGetWMHints: 
XStoreName, XFetchName: 
XSetSizeHints, XGetSizeHints: 
XSetZoomHints, XGetZoom Hints: 
XSetStandardProperties: 
xsetroot: root window parameter 
XBell, XQueryKeymap: manipulate keyboard 
XGetPointerMapping: manipulate pointer 
XSetlconSizes, XGetIconSizes: set or get icon 
XSetSizeHints, XGetSizeHints: set or get window 
XQueryBestStipple: determine efficient 
plaid: paints 
XRestackWindows: change window 
XGetStandardColormap: set or get 
XSetStandardProperties: set 
XSetNormalHints, XGetNormal Hints: set or get normal 
XSetZoomHints, XGetZoomHints: set or get zoom 
XrmQPutStringResource, XrmPutLineResource: 
XSynchronize, XSetAfterFunction: enable or disable 
xterm: 
XDrawlImageString, XDrawImageString 16: draw image 
XDrawText, XDrawText16: draw polytext 
XDrawString, XDrawString16: draw 
xedit: simple 
XQueryTextExtents16: compute or query 
XTextWidth, XTextWidth16: compute 
twm - a window manager for X11 
XPutImage, XGetlmage, X GetSubImage: 
XGetTransientForHint: set or get 
XTranslateCoordinates: 
XQueryTree: query window 
XGetMotionEvents, XSendEvent: select event 
XUnmapWindow, XUnmapSubwindows: 
xset: 
XSubImage, XAddPixel, XDestroyImage: image 
xmodmap, xprkbd: keyboard modifier 
xmodmap, xprkbd: keyboard modifier 
xrdb: X server resource database 
xset: user preference 
xsetroot: root window parameter setting 
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Permuted Index 


retrieve database resources and search lists. ..... . . . XrmGetResource(3X) 
return atom mames. . 2... 2 2 ee ee we we we we ee ew XInternAtom(3X) 
root window parameter setting utility for X. Seer. oe . . xsetroot(1) 
routines. XSetArcMode, XSetSubwindowMode, .... . . XSetArcMode(3X) 
routines. XSetClipOrigin, . . 2... ee ee eee . . . XSetClipOrigin(3X) 
routines. . 2... 2 ee ee etciais'al seryiee hee » . « « » XSetFillStyle(3X) 
routines, ....- ce te et tw tee ee we we 6 XSCtFont(3X) 
FOULINES Shar a ins) 86 Re ee ie, 8 ee we ear Wie) XSetLineAttribute(3X) 
routines. XSetState, XSetPanction, XSeiPlancmask, - «+ « « XSetState(3X) 
TOUUINES. ok) es ele eh, le eae, ew ee ee Se XSetTile(3X) 
save set. XChangeSaveSet, XAddToSaveSet, _ oe eo © © «© KChangeSaveSet(3X) 
saver. /XActivateScreenSaver, XResetScreenSaver, . « . « XSetScreenSaver(3X) 
scientific calculatorforX. ....... eer ee eee xcalc(1) 
SCTOON 2» 5, cs, fo) Sie cs? aes Sele sce? 'W. aids Sean ay te ee Jae fans xrefresh(1) 
screen saver. [XActivateScreenSaver, 4g Maelia end, Geter ee xen XSetScreenSaver(3X) 
search lists. /XrmQGetSearchResource: ..... . « - « XrmGetResource(3X) 
search path. XSetFontPath, XGetFontPath, ..... . . . XSetFontPath(3X) 
select event types. /XCheckTypedWindowEvent, ...... XWindowEvent(3X) 
selectinputevents. . 2. 6. 2 se eee eee . .. . . XSelectInput(3X) 
selection. XSetSelectionOwner, XGetSelectionOwner, . « « XSetSelectionOwner(3X) 
server. XOpenDisplay, ..... 2-2. ae. 6 Spaeth oe oe XOpenDisplay(3X) 
SETVETS nse ig 8 ie esl Oe fe eS Re ee er Xserver(1) 
server access control program forX. ....... e+e es xhost(1) 
server font list displayerforX. . . 2... 2+ ee ee ee xlsfonts(1) 
serverforX.1]1. . ... 2.2. 2 2 eee Soe BS Be oh xis(1) 
server resource database utility. gh Savi ay Sven aia eee se, ee xrdb(1) 
set. XChangeSaveSet, XAddToSaveSet, ogee Ie, a wt .« « XChangeSaveSet(3X) 
set colors. et aieh aise) Sn fe: SO Lnei cos Tete eel Vet seu venue Tee ae XStoreColors(3X) 
setcommand atom. . . 2... 6 1 eee sw we we www XSetCommand(3X) 
set, get, or free the font search path. Sgce. Snes - « + « « XSetFontPath(3X) 
setorgetclasshint. . ....... eee. . ee » « « XSetClassHint(3X) 
set or geticonnames. . . 2.6.2 2 2 ee ee ewe . » XSetIconName(3X) 
set or geticon sizehints. ... . 2... 2 ee ew ee . « XSetIconSizeHints(3X) 
set or get normal statehints. .... +... eee . « « « XSetNormalHints(3X) 
set or get standard colormaps. . . 2... + ee eee ee . XSetStandardColormap(3X) 
set or get transient forhint. . . 2... 6... +6... © « XSetTransientForHint(3X) 
set or get window managerhints. ....... =... =. . XSetWMHints(3X) 
set or get window names. . . 1. 2 1 + 6 © © «© © «© ~~ © XStoreName(3X) 
set or get window sizehints. ......4....+ 4... . XSetSizeHints(3X) 
set or get zoom state hints. . ..... +... +... XSetZoomHints(3X) 
set standard window manager properties. ..... . . + - XSetStandardProperties(3X) 
setting utility forX. 2... 2. 1 6 1 ww ee ee we ew ww  «XSUtFOOL(1) 
settings. /XAutoRepeatOn, XAutoRepeatOff, ... .. . . XChangeKeyboardControl(3X) 
settings. XSetPointerMapping, ........... + + XSetPointerMapping(3X) 
size hitite, 3. s ee eee Se ae ee oe ee ew ww ee « 6 XSetlconSizeHints(3X) 
sizehints. ...... ee ew ew ee «6 XSetSizeHints(3X) 
sizes. XQueryBestSize, XQueryBestTile, Slee di See tes Soa XQuery BestSize(3X) 
some plaid-like pattems in an X window. ....... . . plaid(1) 
stacking order. /XCirculateSubwindowsDown, ..... . . XRaiseWindow(3X) 
standard colormaps. XSetStandardColormap, ..... . . XSetStandardColormap(3X) 
standard window manager properties. . . . .... =. . + « XSetStandardProperties(3X) 
state hints... <5. e508. eo gw, Se ee ce ee ee ee . XSetNormalHints(3X) 
statehints.§ ...... «es 6 « « XSetZoomHints(3X) 
store database resources. /XrmPutStringResource, . « « « » XrmPutResource(3X) 
synchronization. . . 1... 2. se eee 2 0 ee © © © © © XSynchronize(3X) 
terminal emulatorforX. . . . 2... +6 +++ 6 «© © «© © « xterm(l) 
TORS OS Cota ne de cas Met ve one et tae, Terie ce: el 8 - » « « - XDrawlmageString(3X) 
HERES + emg eS ae Bh ed GS cee ee ee ow oe © + KDrawText(3X) 
text characters. Tat se Yak, ee aie et ek oe ee oe ee eh © 6XDrawString(3X) 
texteditorforX. . 2... 2 ee eee eee nes - . - xedit(1) 
text extents. /XTextExtents16, XQueryTextExtents, - . « »- « XTextExtents(3X) 
textwidthh ....... artes Sor Tera iede: Gecist 16-4: norte . XTextWidth(3X) 
(Tom’s Window Manager). . .... ce ee we we we ee 6twm(1) 
transferimages. .. Geb iein ee ba ele aha . « .. - » XPutimage(3X) 
transient for hint. XSetTransientForHint, ais 56°, Jp eure: “alte: 48S XSetTransientForHint(3X) 
translate window coordinates. . . 1... ee ee ee we XTranslateCoordinates(3X) . 
treeinformation. .......-..6- oe ee ee © © XQueryTree(3X) 
types. /XCheckTypedEvent, XCheckTypedWindowEvent, . . XWindowEvent(3X) 
unmap windows. . . 2... 6 se ee ee ee en - « XUnmapWindow(3X) 
user preference utilityforX.  . . 2... 2 ee ee ee ee xset(1) 
utilities. XCreateImage, XGetPixel, XPutPixel, ...... XCreateImage(3X) 
utilitiesforX. 2. 1 2 ee ew ee we oe 6 6 « ©» © xmodmap(1) 
utilitiesforX. 2. 2 6 6 6 we ee ew ee ew we tw xprkbd(1) 
TRUELY? ea a ae sees Sw! els es ies Se Co et tat TO Cee inden Ge xrdb(1) 
utility for X cia i) ten Tat Sai. Se! iar AOhEey feu as! a eis far ad ade xset(1) 
utility for X. See lets fai gio Tslgh wed fev doc fo: Gh qe: See cototeh. a7 . . « xsetroot(1) 
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xwininfo: window information 


XQueryColors, XLookupColor: obtain color 

x10toxl1: X 

x10tox11: X version 10 to 

XGetVisuallnfo, XMatch Visuallnfo: obtain 

XText Width, XTextWidth16: compute text 

muncher: draws interesting pattems in an X 

plaid: paints some plaid-like patterns in an X 

xwd: dump an image of an X 

XGetWindowAttributes, XGetGeometry: get current 
XSetWindowBorder, XSetWindowBorderPixmap: change 
XTranslateCoordinates: translate 

xdpr: dump an X 

Xpr: print an X 

XParseGeometry, XGeometry, XParseColor: parse 
xwininfo: 

xmh: X 

wm: a simple real-estate-driven 

uwm: a 

twm -a 

XSetWMHints, XGetWMHints: set or get 

twm - a window manager for X11 (Tom’s 
XSetStandardProperties: set standard 

XStoreName, XFetchName: set or get 

xsetroot: root 

XDeleteProperty: obtain and change 
XGetSelectionOwner, XConvertSelection: manipulate 
XSetSizeHints, XGetSizeHints: set or get 
XCirculateSubwindowsDown, XRestack Windows: change 
X - aportable, network-transparent 

xinit: X 

xlogo: X 

X-X 

XQueryTree: query 

XClearArea, XClearWindow: clear 
XMoveResizeWindow, XSetWindowBorderWidth: configure 
XCreate Window, XCreateSimple Window: create 
XDestroy Window, XDestroySubwindows: destroy 
XMapWindow, XMapRaised, XMapSubwindows: map 
XReparent Window: reparent 

XUnmapWindow, XUnmapSubwindows: unmap 


bitmap: bitmap editor for 

puzzle: 15-puzzle game for 

uwm: a window manager for 

xbiff: mailbox flag for 

xcalc: scientific calculator for 

xclock: analog / digital clock for 

xedit: simple text editor for 

xfd: font displayer for 

xhost: server access control program for 

xload: load average display for 

xlsfonts: server font list displayer for 

xmodmap, xprkbd: keyboard modifier utilities for 
xmodmap, xprkbd: keyboard modifier utilities for 
xprop: property displayer for 

xset: user preference utility for 

xsetroot: root window parameter setting utility for 
xterm: terminal emulator for 

xwininfo: window information utility for 

xwud: image displayer for 


XGetDefault: get 

xrefresh: refresh all or part of an 
XCloseDisplay, XNoOp: connect or disconnect to 
xrdb: 

x10tox11: 

muncher: draws interesting patterns in an 
plaid: paints some plaid-like patterns in an 
xwd: dump an image of an 

xdpr: dump an 

Xpr: print an 

xmh: 

xinit: 
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utility for X. 
uwm: a window manager forX. Sy ex te 
values. XQueryColor, 
version 10 to version 11 protocol converter. ........ 
version 11 protocol converter. 
visual information. . . 


. xwininfo(1) 


uwm(1) 


« XQueryColor(3X) 


x10tox11(1) 


- x10toxi1(1) 


XGetVisuallnfo(3X) 


. XTextWidth(3X) 


window. . . oe ee ee ww ww we ow oe ow we ho hv * 6muncher(1) 
window. ... 6 ee ee woe Song Mat Bier “Ars : . plaid(1) 
WINdOW... 6 ogee Oe lo Seca es eh es we eee oe oe RWC) 


window attribute or geometry. 


window attributes. ee enone: - « « XChangeWindowAttrib 
window coordinates. .. 2... 6 eee eee we wwe XTranslateCoordinates( 
window directly to the printer. ...... 2 ees . xdpr(l) 
window dump. ...... Sabie folk tas ee eet ord > pei tre aos xpr(1) 
window geometry andcolor. ...... +. +...» + XParseGeometry(3X) 
window information utility forX. .....4.-. . . « xwininfo(1) 
window interface to the mh Mail Handler. os 6 ee © 6RMA(1) 
window manager. Sis oie (Be Paso, Tes ale al Sigs Tole oes Ses tense. wml) 
window managerforX. ......-+-2-02-+ 24200686 uwm(1) 
window manager for X11 (Tom’s Window Manager). .. .. twm(1) 
window managerhints. .......4.4.6-. oe © © « «© XSetWMHints(3X) 
Window Manager). ...... Sie eo Ue es eile ot a) ee twml) 
window manager properties. . .. . 2. + «+ 6 + © » « XSetStandardProperties( 
window names. . 2. 2. 66 ee ew ee ewe ewe ws XStoreName(3X) 
window parameter setting utility for X. ah ei Sender TAL Veet Sees xsetroot(1) 
window properties. /XKRotateWindowProperties, ... . . . XGetWindowProperty(3 
window selection. XSetSelectionOwner, .......+6-. XSetSelectionOwner(3X 
window sizehints. . ... 22 2 ee ee eee «+ « « XASetSizeHints(3X) 
window stacking order. [XCirculateSubwindowsUp, . » . . XRaiseWindow(3X) 
window system. .... ++ ee ee ee ee eee ee X(1) 
Window System initializer. ........ eoivie: Se wae REED) 
Window System logo. 2. 2. 2 2. 6 6 2 ee ee © we ew © «XOgO(l) 
Window System server. . . a rr, €1-101/-1 060) 
window tree informationn . . 2... 6 6 © © «© © © © © © XQueryTree(3X) 
windows. . 2... 2 eo» one oe 6 © o © © «© XClearArea(3X) . 
windows. /XMoveWindow, XResizeWindow, oe + « « » « XConfigureWindow(3X) 
windows. . 2. 2. 2 2 6 ee ee ew ew ew ow ww wo © ~KCreateWindow(3X) 
WiNdOWE... 6: i se eo. Se ae ee we . » . . XDestroyWindow(3X) | 
windows. . 2. 6 6 2 6 1 6 © ee we ee we ww oe © XMapWindow(3X) 
windows. . . 2. 2 6 se ee ee ee ew ew we we ow we ow + 6 MREparentWindow(3X) 
windows. . . ee ee ee ee we ew we ee ew ~~ KUnmapWindow(3X) 
wm: a simple real-estate-driven window manager. . ... .. wm(1) 
Dee. hie oo Te Bee sas BR Pe ewe a Bae & @ Sewn DEL) 
Did Saag i Ge ak Sis Sa, Da ie Gi de ahi das Se we ans Ge REZIOT LY 
Ke ete, tes Be Coe Nel BO RS el oe oe es WME) 
Ms ie ae a ee a es eS - .. . . xbiff(1) 
>, Caer ae ee be Veye Je, sa) Ope 8. We ve ee. wo oo SXEAlC(L) 
cr, eras ass 16s Setar Sey We tay re 8: Co) Oly loi, Neb; Dey eee ex tel aces <5 xclock(1) 
>, ee ae ee Secliie: Brtdlin go A alee Uti BS as et sas xedit(1) 
Dea, 2a) arial a a Gan int we ee i agitate) ee Sew iece, SOL) 
St aire” echoes Loe a. to. So) eas Se eee ew ew we © © 6KHOSH(1) 
> re ar ee en Se me ae a Plat ay oad Rss Gh ta a Oe xload(1) 
Dias see hie San es fale ce es alse lea vee BS i Sv Bose Wale xlsfonts(1) 
> Cle a aa ae eee a a gai Ga Can en 6? + « «++ « xmodmap(1) 
Meo. pias GE BS Bae a ae EE Sag os SS . + + + Xprkbd(1) 
> Care ere Mere, etre Se a? Ge la fae si, O05, ve Sate, sa te’, 26 xprop(1) 
Mis. ey Riyal ba Stay, or cas, Sos Seal dee Se, PS ey, BL AB eS a es 8 oe 6 6 © 6xset(1) 
Kat oe tae ee oe Wn ied terpenes Seah a P 7 «+ »  xXsetroot(1) 
Mie haa, Goi -lae fo aes fend, A0? sae heres moh Gi. daihse 6) Ms, Ona wtatctastie xterm(1) 
Re a Ss a al % iy Boks GSR ee. a aaa ae Oa ee Sek KIAMA) 
Mia? ot Scie Bl ena ar ae 8, we ae ewe a Wo el eS xwud(1) 
X - a portable, network- ‘transparent window system. .... . X(1) 
X - X Window System server. . 1... 6 6 2 6 «© © © « « XServer(1) 
X program defaults. . 2... 2 2 6 6 © oe ee © © © © © XGetDefault(3X) 
Xscreen, 2. 0 we wwe we te ee oe ee ee we © 6XPefresh(1) 
X server. XOpenDisplay, . ... 2.» «© 2 + «6 © « « «© « XOpenDisplay(3X) 
X server resource database utility. .......4.. +... xrdb(l) 
X version 10 to version 11 protocol converter. ....... x10tox11(1) 
Xwindow. .....2.24e- o> eh, ese: oe <6 : e « »« muncher(1) 
A WIOW Skee ee Re ew plaid(1) 
X window. ...-. 2. ot fer cette Se ne Soe Sie ae . . » xwd(l1) 
X window directly to the printer. Shae Wal vate x Se » + + © - Xdpr(l) ( 
X window dump. . 2. 2. es ee ee ew ew es . » « xpr(l) 
X window interface to the mh Mail Handler. . . .... =. =. xmh(1) 
X Window System initializer. . . 2... 6 2 © 6 «© © © © Xinit(l) 
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- AGetWindowAttributes 


xlogo: 

X- 

converter. 

xis: server for 

twm - a window manager for 

XSetScreenSaver, XForceScreenSaver, 
XRemoveHosts, XSetAccessControl,/ 
XSetAccessControl, XEnableAccessControl,/ XAddHost, 
XCreatelmage, XGetPixel, XPutPixel, XSublmage, 
client’s save set. XChangeSaveSet, 
XAllocColorPlanes, XFreeColors: allocate and free/ 
allocate and free/ XAllocColor, XAllocNamedColor, 
XAllocColor, XAllocNamedColor, XAllocColorCells, 
XAllocColorPlanes, XFreeColors:/ XAllocColor, 


keyboard/ /XGetKeyboardControl, XAutoRepeatOn, 
XChangeKeyboardControl, XGetKeyboardControl, 
/XGetKeyboardControl, XAutoRepeatOn, XAutoRepeatOff, 


XGrabPointer, X UngrabPointer, 

contexts. XCreateGC, XCopyGC, 

XAutoRepeatOn, XAutoRepeatOff, XBell / 
XSetModifierMapping, XGetModifierMapping,/ 

pointer. 

XGetWindowProperty, XListProperties, 

change a client’s save set. 
XSetWindowBackgroundPixmap, XSetWindowBorder,/ 
XIfEvent, 

XWindowEvent, XCheckWindowEvent, XMaskEvent, 
[XCheckWindowEvent, XMaskEvent, XCheckMaskEvent, 
/XMaskEvent, XCheckMaskEvent, XCheckTypedEvent, 
XCheckTypedEvent,/ XWindowEvent, 

XRaiseWindow, XLowerWindow, 
/XCirculateSubwindows, XCirculateSubwindowsUp, 
XRaiseWindow, XLowerWindow, XCirculateSubwindows, 


XClearArea, 
XPolygonRegion, 


server. XOpenDisplay, 
XMoveResizeWindow, XSetWindowBorderWidth:/ 
XSetSelectionOwner, XGetSelectionOwner, 


XSetWindowColormap: create, copy,/ XCreateColormap, 
graphics contexts. XCreateGC, 

XCopyArea, 

[XW riteBitmapFile, XCreatePixmapFromBitmapData, 
XFreeColormap, XSetWindowColormap: create, copy,/ 
XCreateGlyphCursor: create cursors. 

free graphics contexts. 

XCreateFontCursor, XCreatePixmapCursor, 
XAddPixel, X DestroyImage: image utilities. 

pixmaps. 

cursors. XCreateFontCursor, 

manipulate/ XReadBitmapFile, XWriteBitmapFile, 
and destroy regions. 

XCreateWindow, 


context manager, XSaveContext, XFindContext, 
[XNewModifierMap, XInsertModifiermapEntry, 
/XChangeProperty, XRotateWindowProperties, 
XGetPixel, XPutPixel, XSubImage, XAddPixel, 
XCreateRegion, XSetRegion, 

XDestroy Window, 

windows. 

/XSetAccessControl, XEnableAccessControl, 
handlers. /XGetErrorText, XGetErrorDatabaseText, 


XDrawAre, 

text. 
XDrawImageString, 
and polygons. 
XDrawLine, 
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Permuted Index 


X Window System logo. . 2 2. 2 1 2 ee ee ee ee 
X Window System server. 
x10tox11: X version 10 to version 11 protocol 
X11. 
X11 (Tom’s Window Manager). 
XActivateScreenSaver, XResetScreenSaver,/ 
XAddHost, XAddHosts, XListHosts, XRemoveHost, . 
XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, 
XAddPixel, XDestroyImage: image utilities. 
XAddToSaveSet, XRemoveFromSaveSet: change a 
XAllocColor, XAllocNamedColor, XAllocColorCells, 
XAllocColorCells, XAllocColorPlanes, XFreeColors: 
XAllocColorPlanes, XFreeColors: allocate and free/ 
XAllocNamedColor, XAllocColorCells, 
XAllowEvents: continue frozen event processing. 
XAutoRepeatOff, XBell, XQueryKeymap: manipulate 
XAutoRepeatOn, XAutoRepeatOff, XBell,/ 
XBell, XQueryKeymap: manipulate keyboard settings. 
xbiff: mailbox flag for X. 
xcalc: scientific calculator for X. 
XChangeActivePointerGrab: manipulate the pointer. 
XChangeGC, XFreeGC: create and free graphics 
XChangeKeyboardControl, XGetKeyboardControl, 
XChangeKeyboardMapping, XGetKeyboardMapping, 
XChangePointerControl, XGetPointerControl: control 
XChangeProperty, XRotateWindowProperties,/ 
XChangeSaveSet, XAddToSaveSet, XRemoveFromSaveSet: 
XChangeWindowAttributes, XSetWindowBackground, 
XCheckIfEvent, XPeekIfEvent: check the event queue. 
XCheckMaskEvent, XCheckTypedEvent,/ 
XCheckTypedEvent, XCheckTypedWindowEvent,/ 
XCheckTypedWindowEvent, XGetMotionEvents,/ 
XCheckWindowEvent, XMaskEvent, XCheckMaskEvent, 
XCirculateSubwindows, XCirculateSubwindowsUp,/ ‘ 
XCirculateSubwindowsDown, XRestackWindows: change/ 
XCirculateSubwindowsUp, XCirculateSubwindowsDown,/ 


ee 8 e@ © © © # @ © #@ ee 8 ee & ©& 


ee © © e@ 8 © © © © © @ #8 © © © © © © ew © @ @ 


ee 2 @ e «© ee © © © e @ @ «& 


oe e e @ @ 


e s e© «© © © © # © @© @ @ 


xlogo(1) 

Xserver(1) 
x10tox11(1) 

xis(1) 

twm(1) 
XSetScreenSaver(3X) 


. » XAddHost(3X) 
. XAddHost(3X) 


XCreateImage(3X) 
XChangeSaveSet(3X) 


. « XAllocColor(3X) 
« XAllocColor(3X) 


XAllocColor(3X) 
XAllocColor(3X) 
XAllowEvents(3X) 


. XChangeKeyboardControl(3X) 


XChangeKeyboardControl(3X) 


. XChangeKeyboardControl(3X) 


xbiff(1) 
xcalc(1) 


. XGrabPointer(3X) 


XCreateGC(3X) 
XChangeKeyboardControl(3X) 


. . XChangeKeyboardMapping(3X} 
. XChangePointerControl(3X) 


XGetWindowProperty(3X) 


. XChangeSaveSet(3X) 
. . XChangeWindowAttributes(3X) 
. XIfEvent(3X) 


XWindowEvent(3X) 
XWindowEvent(3X) 
XWindowEvent(3X) 


. « XWindowEvent(3X) 
. « XRaiseWindow(3X) 
. » XRaiseWindow(3X) 

. XRaiseWindow(3X) 


XClearArea, XClearWindow: clear windows. ....... XClearArea(3X) 
XClearWindow: clear windows. .......-. . . XClearArea(3X) 
XClipBox: generate regions. ......----+0200- XPolygonRegion(3X) 
xclock: analog / digital clockforX. ........2.e.e-s xclock(1) 
XCloseDisplay, XNoOp: connect or disconnecttoX .. . . . XOpenDisplay(3X) 
XConfigureWindow, XMoveWindow, XResizeWindow, . XConfigureWindow(3X) 
XConvertSelection: manipulate window selection. ..... XSetSelectionOwner(3X) 
XCopyArea, XCopyPlane: copy areas. .. 1... ee eee XCopyArea(3X) 
XCopyColormapAndFree, XFreeColormap, ........ XCreateColormap(3X) 
XCopyGC, XChangeGC, XFreeGC: createandfree ..... XCreateGC(3X) 
XCopyPlane: copy areas. 6 1 ww we ee ee we ee XCopyArea(3X) 
XCreateBitmapFromData: manipulate bitmaps. ....... XReadBitmapFile(3X) 
XCreateColormap, XCopyColormapAndFree, ....... XCreateColormap(3X) 
XCreateFontCursor, XCreatePixmapCursor, ........ XCreateFontCursor(3X) 
XCreateGC, XCopyGC, XChangeGC, XFreeGC: createand . XCreateGC(3X) 
XCreateGlyphCursor: create cursors. . 6. 6 2 6 ee ee ee XCreateFontCursor(3X) 
XCreateImage, XGetPixel, XPutPixel, XSubIlmage, ..... XCreateImage(3X) 
XCreatePixmap, XFreePixmap: create and destroy ..... XCreatePixmap(3X) 


XCreatePixmapCursor, XCreateGlyphCursor: create 
XCreatePixmapFromBitmapData, XCreateBitmapFrom Data: 


XDrawLine, XDrawLines, XDrawSegments: draw lines 
XDrawLines, XDrawSegments: draw lines and polygons. 
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. « XCreateFontCursor(3X) 
. XReadBitmapFile(3X) 


XCreateRegion, XSetRegion, XDestroyRegion: create . XCreateRegion(3X) 
XCreateSimple Window: create windows. . ......+ 4. XCreateWindow(3X) 
XCreateWindow, XCreateSimple Window: create windows. . XCreateWindow(3X) 
XDefineCursor, XUndefineCursor: define cursors. ..... XDefineCursor(3X) 
XDeleteContext, XUniqueContext: manipulatethe ..... XSaveContext(3X) 
XDeleteModifiermapEntry, XFreeModifierMap: ...... XChangeKeyboardMapping(3X} 
XDeleteProperty: obtain and change window/  ....... XGetWindowProperty(3X) 
XDestroyImage: image utilities. XCreateImage, ...... XCreateImage(3X) 
XDestroyRegion: create and destroy regions. ........ XCreateRegion(3X) 
XDestroySubwindows: destroy windows. . ..... +4. XDestroyWindow(3X) 
XDestroy Window, XDestroySubwindows: destroy ..... XDestroyWindow(3X) 
XDisableAccessControl: control host access. . . . 1... 6 « XAddHost(3X) 
XDisplayName, XSetIOErrorHandler: defaulterror ..... XSetErrorHandler(3X) 
xdpr: dump an X window directly tothe printer. ...... xdpr(1) 

XDrawArc, XDrawAres: draw arcs. 2... 6 ee ee es XDrawArc(3X) 
XDrawAres: draw arcs, 6 6 5 ww we ww te ew we XDrawArc(3X) 
XDrawimageString, XDrawlmagestring 16: draw i image . XDrawlmageString(3X) 
XDrawImageString16: draw image text. . . 1°... 2s XDrawlmageString(3X) 


. XDrawLine(3X) 
. XDrawLine(3X) 
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XDrawPoint, 


XDrawRectangle, 
XDrawLine, XDrawLines, 


XDrawString, 
XDrawText, 


are empty or equal. 

/XRemoveHost, XRemoveHosts, XSetAccessControl, 
equal. XEmptyRegion, 

basic error handling. XFlush, XSync, 


paste/ XStoreBytes, XStoreBuffer, XFetchBytes, 
manipulate cut and/ XStoreBytes, XStoreBuffer, 
, XStoreName, 
XFillRectangle, XFillRectangles, XFillPolygon, 
/XFillRectangles, XFillPolygon, XFillArc, 
polygons, or/ XFillRectangle, XFillRectangles, 
XFillArc, XFillArcs: fill rectangles, polygons, or/ 
fill rectangles, polygons, or/ XFillRectangle, 
manipulate the context manager. XSaveContext, 
XPeekEvent: basic error handling. 
XResetScreenSaver,/ XSetScreenSaver, 


destroy/ XCreateColormap, XCopyColormapAndFree, 
/XAllocColorCells, XAllocColorPlanes, 
XRecolorCursor, 

/XListFontsWithInfo, XFreeFontInfo, XLoadQueryFont, 
XLoadFont, XQueryFont, XListFontsWithInfo, 
XListFonts, 

path. XSetFontPath, XGetFontPath, 

XCreateGC, XCopyGC, XChangeGC, 
XInsertModifiermapEntry, XDeleteModifiermapEntry, 
XCreatePixmap, 

XFreeFont, XGetFontProperty, XUnloadFont, 

color. XParseGeometry, 

XIntemAtom, 

XSetClassHint, 


XSetErrorHandler, XGetErrorText, 
XSetIOErrorHandler: default/ XSetErrorHandler, 
font search path. XSetFontPath, 

/XFreeFontInfo, XLoadQueryFont, XFreeFont, 
geometry. XGetWindowA ttributes, 
XSetIconName, 

XSetlIconSizes, 

XPutimage, 

XSetInputFocus, 

XBell, XQueryKeymap:/ XChangeKeyboardControl, 
XGetModifierMapping,/ XChangeKeyboardMapping, 
/XGetKeyboardMapping, XSetModifierMapping, 
/XCheckTypedEvent, XCheckTyped Window Event, 
XSetNommalHints, 

XDestroyilmage: image utilities. XCreatelmage, 
XChangePointerControl, 

XSetPointerMapping, 

/XActivateScreenSaver, XResetScreenSaver, 
window selection. XSetSelectionOwner, 
XSetSizeHints, 

colormaps. XSetStandardColormap, 

XPutlmage, XGetImage, 

hint. XSetTransientForHint, 

information. 

window attribute or geometry. 

XChangeProperty, XRotateWindowProperties,/ 
XSetWMHints, 

XSetZoomHints, 


keyboard. 
XChangeActivePointerGrab: manipulate the pointer. 
keyboard. 
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XDrawPoint, XDrawPoints: draw points. 


. XGrabKey, XUngrabKey: manipulate the keyboard. 


oi at a oy fetes Gate <S XDrawPoint(3X) 
XDrawPoints: draw points. . . . 2 6 2 ee ew et ee ew XDrawPoint(3X) 
XDrawRectangle, XDrawRectangles: draw rectangles. . XDrawRectangle(3X) 
XDrawRectangles: draw rectangles. .... 2... 2 eo XDrawRectangle(3X) 
XDrawSegments: draw lines and polygons. ....+.+.- XDrawLine(3X) 
XDrawString, XDrawString 16: draw text characters. . XDrawString(3X) 
XDrawString16: draw text characters. . 2... 6 ee eo XDrawString(3X) 
XDrawText, XDrawTextl6: draw polytext text. . ..... XDrawText(3X) 
XDrawTextl6: draw polytexttext. . 2... 2 ee ee eee XDrawText(3X) 
xedit: simple text editorforX. . 2... 2 s+ + eee xedit(1) 
XEmptyRegion, XEqualRegion: determine if regions . XEmptyRegion@GX) 
XEnableAccessControl, XDisableAccessControl:/ .... .- XAddHost(3X) 
XEqualRegion: determine if regions areemptyor ...... XEmptyRegion(3X) 
XEventsQueued, XPending, XNextEvent, XPeekEvent: . . XFlush(3X) 
xfd: font displayerforX. 2... 1 6 2 ee ew we ee ewes xfd(1) 
XFetchBuffer, XRotateBuffers: manipulate cutand ..... XStoreBytes(3X) 
XFetchBytes, XFetchBuffer, XRotateBuffers: ....... XStoreBytes(3X) 
XFetchName: set or get window names. .....-2.2.-. XStoreName(3X) 
XFillArc, XFillAres: fill rectangles, polygons, or/ . ..... XFillRectangle(3X) 
XFillArcs: fill rectangles, polygons, or arcs. .... 2. 6 XFillRectangle(3X) 
XFillPolygon, XFillArc, XFillAres: fill rectangles, ..... XFillRectangle(3X) 
XFillRectangle, XFillRectangles, XFillPolygon, ...... XFillRectangle(3X) 
XFillRectangles, XFillPolygon, XFillArc, XFillArcs: . XFillRectangle(3X) 
XFindContext, XDeleteContext, XUniqueContext:. ..... XSaveContext(3X) 
XFlush, XSync, XEventsQueued, XPending, XNextEvent, . XFlush@GX) 
XForceScreenSaver, XActivateScreenSaver, .....-... XSetScreenSaver(3X) 
XFree, XNoOp: free client data. . 2... 2... 2 2 ee ee XFree(3X) 
XFreeColormap, XSetWindowColormap: create, copy, or . XCreateColormap(3X) 
XFreeColors: allocate and freecolors,5 ......-+.s46- XAllocColor(3X) 
XFreeCursor, XQueryBestCursor: manipulate cursors. . XRecolorCursor(3X) 
XFreeFont, XGetFontProperty, XUnloadFont,/ ....... XLoadFont(3X) 
XFreeFontInfo, XLoadQueryFont, XFreeFont/ ....... XLoadFont(3X) 
XFreeFontNames: obtain and freefontnames. ....... XListFonts(3X) 
XFreeFontPath: set, get, orfreethe font search . ...... XSetFontPath(3X) 
XFreeGC: create and free graphics contexts. . ..... . . XCreateGC(3X) 
XFreeModifierMap: /XNewModifierMap, ........ XChangeKeyboardMap; 
XFreePixmap: create and destroy pixmaps. ........ XCreatePixmap(3X) 


XGContextFromGC: manipulate fonts. /XLoadQueryFont, 
XGeometry, XParseColor: parse window geometry and - 
XGetAtomName: create and return atom names. ..... 


XGrabButton, XUngrabButton: manipulate the pointer. 


XGrabKeyboard, XUngrabKeyboard: manipulate the 


. « XLoadFont(3X) 
. XParseGeometry(3X) | 


. XIntemnAtom(3X) 
XGetClassHint: set or getclasshint’ . . 2... 2 1 ee a XSetClassHint(3X) 
XGetDefault: get X program defaults; ........ . - XGetDefault(3X) 
XGetErrorDatabaseText, XDisplayName/ .... .. . . . XSetErrorHandler(3X) 
XGetErrorText, XGetErrorDatabaseText, XDisplayName, . . XSetErrorHandler(3X) 
XGetFontPath, XFreeFontPath: set, get, orfreethe ..... XSetFontPath(3X) 
XGetFontProperty, XUnloadFont, XGContextFromGC:/ - XLoadFont(3X) 
XGetGeometry: get current window attributeor ...... XGetWindowA ttributes( 
XGetIconName: set or geticonmames. ....- + «se + XSetlconName(3X) 
XGetlconSizes: set or get icon size hints. ........- XSetlconSizeHints(3X) 
XGetImage, XGetSubImage: transferimages. ....... XPutlmage(3X) 
XGetInputFocus: control input focus. . . . 2... 2 6 ee XSetInputFocus(3X) 
XGetKeyboardControl, XAutoRepeatOn, XAutoRepeatOff, . . XChangeKeyboardConts 
XGetKeyboardMapping, XSetModifierMapping, ...... XChangeKeyboardMapp 
XGetModifierMapping, XNewModifierMap/ ....... XChangeKeyboardMapp 
XGetMotionEvents, XSendEvent: select event types. . XWindowEvent(3X) 
XGetNommalHints: set or get normal statehints.§ ...... XSetNormalHints(3X) 
XGetPixel, XPutPixel, XSubIlmage, XAddPixel, ...... XCreateImage(3X) 
XGetPointerControl: control pointer. . . . 6. 2. 2 2 2 ow XChangePointerControl( 
XGetPointerMapping: manipulate pointer settings. ..... XSetPointerMapping(3X 
XGetScreenSaver: manipulate the screen saver. . . . . 2. « -XSetScreenSaver(3X) 
XGetSelectionOwner, XConvertSelection: manipulate - XSetSelectionOwner(3X 
XGetSizeHints: set or get window sizehints. . ....... XSetSizeHints(3X) 
XGetStandardColormap: set or get standard  . 2. 1 1 2 o © XSetStandardColormap(: 
XGetSublmage: transferimages. . .... 2.6 ee © © XPutimage(3X) 
XGetTransientForHint: set or get transientfor ....... XSetTransientForHint(33 
XGetVisualinfo, XMatchVisualInfo: obtain visual ..... XGetVisualinfo(3X) 
XGetWindowAttributes, XGetGeometry: get current - « « « XGetWindowAttributes(: 
XGetWindowProperty, XListProperties, ......-+.+-. XGetWindowProperty(3? 
XGetWMHints: set or get window managerhints. ...... XSetWMHints(3X) 
XGetZoom Hints: set or get zoom state hints. ......4.. XSetZoomHints(3X) 


.» XGrabButton(3X) 


XGrabKey(3X) 


. XGrabKeyboard(3X) 


XGrabPointer, XUngrabPointer, - . 2... 2. + 2 ee ee XGrabPointer(3X) 
XGrabServer, XUngrabServer: manipulatethe ....... XGrabServer(3X) 
xhost: server access control program forX. ..... 2s. xhost(1) 

- Xiv - INTEGRATED SOLUTIONS 


event queue. 


/XGetModifierMapping, XNewModifierMap, 
XListInstalledColormaps: install colormaps. 

; names. 
XUnionRectWithRegion, XSubtractRegion / 


keysyms. XStringToKeysym, XKeysymToString, 
XStringToKeysym, XKeysymToString, XKeycodeToKeysym, 
XKeysymToKeycode: convert/ XStringToKeysym, 
XSetCloseDownMode, 

names. 

XFreeFont,/ XLoadFont, XQueryFont, 

XSetAccessControl,/ XAddHost, XAddHosts, 
XInstallColormap, XUninstallColormap, 
XRotateWindowProperties,/ XGetWindowProperty, 


XFreeFontInfo, XLoadQueryFont, XFreeFont,/ 
/XQueryFont, XListFontsWithInfo, XFreeFontInfo, 


XQueryColor, XQueryColors, 

XLookupString, XRebindKeySym: handle keyboard/ 
events. XLookupKeysym, XRefreshKeyboardMapping, 
XCirculateSubwindowsUp,/ XRaiseWindow, 


XMapWindow, 

XMap Window, XMapRaised, 

windows. 

XWindowEvent, XCheckWindowEvent, 
XGetVisualInfo, 


XConfigureWindow, XMoveWindow, XResizeWindow, 
XSetWindowBorderWidth: configure/ XConfigureWindow, 
/XSetModifierMapping, XGetModifierMapping, 

XFiush, XSync, XEventsQueued, XPending, 


XOpenDisplay, XCloseDisplay, 


/XUnionRectWithRegion, XSubtractRegion, XXorRegion, 
disconnect to X server. 

XParseGeometry, XGeometry, 

window geometry and color. 

XFlush, XSync, XEventsQueued, XPending, XNextEvent, 
XIfEvent, XCheckIfEvent, 

handling. XFlush, XSync, XEventsQueued, 
/XXorRegion, XOffsetRegion, XShrinkRegion, 


images. 

image utilities. XCreateImage, XGetPixel, 
XRecolorCursor, XFreeCursor, 

determine efficient sizes. 

XQueryBestSize, X QueryBestTile, 

efficient sizes. XQueryBestSize, 

color values. 

XQueryColor, 

XLoadQueryFont, XFreeFont,/ XLoadFont, 
/XAutoRepeatOn, XAutoRepeatOff, XBell, 


query text extents. XTextExtents, XTextExtents16, 
XTextExtents, XTextExtents16, XQueryTextExtents, 


XCirculateSubwindowsUp, XCirculateSubwindowsDown,/ 


XCreatePixmapFromBitmapData,/ 
/XRefreshKeyboardMapping, XLookupString, 
manipulate cursors. 

XOffsetRegion, XShrinkRegion, XPointInRegion, 


Rens yah handle keyboard/ XLookupKeysym, 
XChangeSaveSet, XAddToSaveSet, 


INTEGRATED SOLUTIONS 


XIfEvent, XCheckIfEvent, XPeekIfEvent: check the ..... 


xinit: X Window System initializer. 
XInsertModifiermapEntry, XDeleteModifiermapEntry,/ 


XInstallColormap, XUninstallColormap, .......-.. 
. XInternAtom(3X) 


XInternAtom, XGetAtomName: create and return atom 


XIntersectRegion, XUnionRegion, . ........-e+.-. 
Kis: server for Xb sana es 58 wa ee ee ee ee 
. XStringToKeysym(3X) 


XKeycodeToKeysym, XKeysymToKeycode: convert 
XKeysymToKeycode: convert keysyms. 

XKeysymToString, XKeycodeToKeysym, 
XKillClient: control clients. 


XListFonts, XFreeFontNames: obtain andfreefont ..... 
. « XLoadFont(3X) 


XListFontsWithInfo, XFreeFontinfo, XLoadQueryFont, 
XListHosts, XRemoveHost, XRemoveHosts, 


XListInstalledColormaps: install colormaps. . .... + + 


XListProperties, XChangeProperty, 


xload: load average display forX. . . ee ae ae 


XLoadFont, XQueryFont, XListFontsWithInfo, 


XLoadQueryFont, XFreeFont, XGetFontProperty/ ..... 
xlogo: X Window System logo. . ... 2.5. see es 


XLookupColor: obtain color values. 
XLookupKeysym, XRefreshKeyboardMapping, 
XLookupString, XRebindKeySym: handle keyboard input 
XLowerWindow, XCirculateSubwindows, 


xlsfonts: server font list displayerforX. ........+2-. 
XMapRaised, XMapSubwindows: map windows. ..... .- 


XMapSubwindows: map windows. 
XMap Window, XMapRaised, XMapSubwindows: map 
XMaskEvent, XCheckMaskEvent, XCheckTypedEvent,/ 
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. XChangeKeyboardMapping(3X} 
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- XLookupKeysym(3X) 


. - XMapWindow(3X) 
. XWindowEvent(3X) 


Permuted Index 


XifEvent(3X) 
xinit(1) 


XInstallColormap(3X) 


XIntersectRegion(3X) 
xis(1) 


XStringToKeysym(3X) 
XStringToKeysym(3X) 
XSetCloseDownMode(3X) 
XListFonts(3X) 


XAddHost(3X) 
XInstallColormap(3X) 
XGetWindowProperty(3X) 
xload(1) 

XLoadFont(3X) 
XLoadFont(3X) 

xlogo(1) 
XQueryColor(3X) 
XLookupKeysym(3X) 


XRaiseWindow(3X) 
xisfonts(1) 
XMapWindow(3X) 
XMapWindow(3X) 


XMatch Visualinfo: obtain visual information. ......- XGetVisualInfo(3X) 
xmh: X window interface to the mh Mail Handler. .... xmh(1) 

xmodmap, xprkbd: keyboard modifier utilities for X. . xmodmap(1) 
xmodmap, xprkbd: keyboard modifier utilities for X. - xprkbd(1) 


XMoveResizeWindow, XSetWindowBorderWidth: configure/ 
XMoveWindow, XResizeWindow, XMoveResize Window, 


XNewModifierMap, XInsertModifiermapEntry/ ..... 


XNextEvent, XPeekEvent: basic error handling. 
XNoOp: connect or disconnect to X server. 


XNoOp: free clientdata. . 2... 2. 2. 2 ee we eee 
XOffsetRegion, XShrinkRegion, XPointInRegion/ ... . 
XOpenDisplay, XCloseDisplay, XNoOp: connector ... . 
XParseColor: parse window geometry andcolor,. ..... 
XParseGeometry, XGeometry, XParseColor: parse .... 
XPeekEvent: basicerrorhandling. ......+-.+6- 


XPeeklfEvent: check the event queue. 


XPending, XNextEvent, XPeekEvent: basicerror ..... 
XPointInRegion, XRectInRegion: region arithmetic. . ... 
XPolygonRegion, XClipBox: generate regions. . ..... 


xpr: print an X window dump. 


xprkbd: keyboard modifier utilities forX. .....4.4.. 
xptkbd: keyboard modifier utilities forX. . ....... 
xprop: property displayerforX. . . 2... 2... see. 
XPutBackEvent: put events back on the queue. ...... 
XPutimage, XGetImage, XGetSublmage: transfer . . . . . 


XPutPixel, XSubImage, XAddPixel, XDestroyImage: 
XQueryBestCursor: manipulate cursors. 
XQueryBestSize, XQuery BestTile, XQuery BestStipple: 
XQueryBestStipple: determine efficient sizes. 


XQueryBestTile, XQueryBestStipple: determine ..... 


XQueryColor, XQueryColors, XLookupColor: obtain 


XQueryColors, XLookupColor: obtain colorvalues. . .... 
XQueryFont, XListFontsWithInfo, XFreeFontInfo, ... . 


XQueryKeymap: manipulate keyboard settings. 
XQueryPointer: get pointer coordinates. 
XQueryTextExtents, XQueryTextExtents 16: compute or 
XQueryTextExtents 16: compute or query text extents. 

XQueryTree: query window tree information. 
XRaiseWindow, XLowerWindow, XCirculateSubwindows, 


xrdb: X server resource database utility. ... ....... 


XReadBitmapFile, XWriteBitmapFile, 


XRebindKeySym: handle keyboard input events. ..... 
XRecolorCursor, XFreeCursor, XQueryBestCursor:; ... . 
XRectInRegion: region arithmetic. /XXorRegion, ... . 
xrefresh: refresh all or part ofan X screen. . ......- 
XRefreshKeyboardMapping, XLookupString, ...... 
XRemoveFromSaveSet: change a client’s save set... ee 


-XxXv- 


. XConfigureWindow(3X) 
. XConfigureWindow(3X) 


XChangeKeyboardMapping(3X} 
XFlush(3X) 
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. XOpenDisplay(3X) 
. XFree(3X) 

. XiIntersectRegion(3X) 
- XOpenDisplay(3X) 
. XParseGeometry(3X) 
. XParseGeometry(3X) 
. XFlush(X) 

.. XifEvent(3X) 

. XFlush(3X) 

. XIntersectRegion(3X) 
. XPolygonRegion(3X) 
- xpr(1) 

- xmodmap(1) 

- xprkbd(1) 

- xprop(1) 

. XPutBackEvent(3X) 
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. XPutlmage(3X) 
. XCreateImage(3X) 


XRecolorCursor(3X) 


. XQueryBestSize(3X) 


XQueryBestSize(3X) 
XQueryBestSize(3X) 


- XQueryColor(3X) 


XQueryColor(3X) 
XLoadFont(3X) 
XChangeKeyboardControl(3X) 
XQuery Pointer(3X) 


. XTextExtents(3X) 
. XTextExtents(3X) 


XQueryTree(3X) 


. XRaiseWindow(3X) 


. xrdb(1) 

. XReadBitmapFile(3X) 
. XLookupKeysym(3X) 
- XRecolorCursor(3X) 
. XIntersectRegion(3X) 
. xrefresh(1) 

- XLookupKeysym(3X) 
. XChangeSaveSet(3X) 
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Permuted Index 


XAddHost, XAddHosts, XListHosts, 
XAddHost, XAddHosts, XListHosts, XRemoveHost, 


screen/ /XForceScreenSaver, XActivateScreenSaver, 
XConfigure Window, XMoveWindow, 
/XCirculateSubwindowsUp, XCirculateSubwindowsDown, 
XrmGetStringDatabase:/ XrmMergeDatabases, 
XrmQGetSearchResource: retrieve database resources/ 
databases. /XrmGetFileDatabase, XrmPutFileDatabase, 
Resource Manager and parse the command line. 
XrmPutFileDatabase, XrmGetString Database:/ 

and parse the command line. Xrmlnitialize, 

manipulate/ XrmMergeDatabases, XrmGetFileDatabase, 
/XrmPutStringResource, XrmQPutStringResource, 
XrmPutStringResource, XrmQPutStringResource,/ 
XrmPutResource, XrmQPutResource, 
XrmQGetSearchResource: retrieve/ XrmGetResource, 
database/ XrmGetResource, XnmQGetResource, 
XrmGetResource, XrmQGetResource, XrmQGetSearchList, 
XmmQPutStringResource,/ XrmPutResource, 

database/ /XrmQPutResource, XrmPutStringResource, 
XrmUniqueQuark, XmmStringToQuark, 

quarks. /XrmQuarkToString, XrmStringToQuark List, 
XmmStringToQuarkList,/ XrmUniqueQuark, 
XrmUniqueQuark, XrmStringToQuark, XrmQuarkToString, 
XrmStringToQuarkList, XrmStringToBindingQuarkList:/ 
/XStoreBuffer, XFetchBytes, XFetchBuffer, 

and change/ /XListProperties, XChangeProperty, 
XUniqueContext: manipulate the context manager. 


XCheckTypedWindowEvent, XGetMotionEvents, 


XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, 
synchronization. XSynchronize, 

XSetGraphicsExposure: GC convenience routines. 
/XSetFunction, XSetPlanemask, XSetForeground, 

hint. 

routines. XSetClipOrigin, 

GC convenience routines. 

XSetClipOrigin, XSetClipMask, 


XSetLineAttribute, 
XGetErrorDatabaseText, XDisplayName,/ 
XSetFillStyle, 

routines. 


get, or free the font search path. 

routines. XSetState, XSetFunction, XSetPlanemask, 
XSetBackground: GC convenience/ XSetState, 
XSetArcMode, XSetSubwindow Mode, 


hints. 

focus. 

/XGetErrorText, XGetErrorDatabaseText, XDisplayName, 
routines. 

XChangeKeyboardMapping, XGetKeyboardMapping, 
state hints. 

convenience routines. XSetState, XSetFunction, 

pointer settings. 

regions. XCreateRegion, 


X. xsetroot: root window parameter setting utility for 


XActivateScreenSaver, XResetScreenSaver,/ 
XConvertSelection: manipulate window selection. 

size hints. 

get standard colormaps. 

properties. 

XSetForeground, XSetBackground: GC convenience/ 
XSetTile, 

convenience routines. XSetArcMode, 

routines. 

get transient for hint. 

XSetTile, XSetStipple, 

XSetWindowBorder,/ XChange Window Attributes, 
XChange WindowAttributes, XSetWindowBackground, 
. [XSetWindowBackground, XSetWindowBackgroundPixmap, 
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XRemoveHost, XRemoveHosts, XSetAccessControl,/ 


. » XKAddHost(3X) 


XRemoveHosts, XSetAccessControl/ ......2-22465 XAddHost(3X) 
XReparentWindow: reparent windows. ......-.-2e- XReparentWindow(3X 
XResetScreenSaver, XGetScreenSaver: manipulate the . . . XSetScreenSaver(3X) 
XResizeWindow, XMoveResizeWindow/ ........-. XConfigureWindow(3: 
XRestackWindows: change window stacking order. . .. . . XRaiseWindow(3X) 
XrmGetFileDatabase, XrmPutFileDatabase, ........ XrmMergeDatabases(3 
XrmGetResource, XrmQGetResource, XrmQGetSearchList, . XrmGetResource(3X) 
XrmGetStringDatabase: manipulate resource ....... XrmMergeDatabases(3. 
Xnmlnitialize, XrmParseCommand: initialize the ..... . Xrmlnitialize(3X) 
XrmMergeDatabases, XrmGetFileDatabase, ........ XrmMergeDatabases(3. 
XrmParseCommand: initialize the Resource Manager . Xrmlnitialize(3X) 
XrmPutFileDatabase, XrmGetStringDatabase: ....... XrmMergeDatabases(3. 
XrmPutLineResource: store database resources. . .... XrmPutResource(3X) 
XrmPutResource, XrmQPutResource, .. . +. 6 ee ee XrmPutResource(3X) 
XrmPutStringResource, XrmQPutStringResource, ..... XrmPutResource(3X) 
XrmQGetResource, XrmQGetSearchList, . ........ XrmGetResource(3X) 


XrmQGetSearchList, XnnQGetSearchResource: retrieve 
XrmQGetSearchResource: retrieve database resources/ 


. XrmGetResource(3X) 
. XrmmGetResource(3X) 


XrmQPutResource, XrmPutStringResource, .......- XrmPutResource(3X) 
XrmQPutStringResource, XrmPutLineResource: store - XrmPutResource(3X) 
XrmQuarkToString, XrmStringToQuarkList/ ....... XrmUniqueQuark(3X) 
XrmStringToBindingQuarkList: manipulate resource - XrmUniqueQuark 3X) 
XrmStringToQuark, XrmQuarkToString, .......+.- XrmUniqueQuark(3X) 
XrmmStringToQuarkList, XrmStringToBinding QuarkList:/ - XrmUniqueQuark(3X) 
XrmUniqueQuark, XrmStringToQuark, XrmQuarkToString, . XrmUniqueQuark(3X) 
XRotateBuffers: manipulate cut and paste buffers. ..... XStoreBytes(3X) 
XRotateWindowProperties, XDeleteProperty: obtain . XGetWindowProperty(. 
XSaveContext, XFindContext, XDeleteContext, ...... XSaveContext(3X) 
XSelectInput: select inputevents. ......6.20e808 XSelectInput(3X) 
XSendEvent: select event types. /XCheckTypedEvent, . XWindowEvent(3X) 
xset: user preference utility forX. . . 1... 6 2 ee ewe xset(1) 
XSetAccessControl, XEnableAccessControl,/ XAddHost, . XAddHost(3X) 
XSetAfterFunction: enable ordisable ... 2... 2 eee XSynchronize(3X) 
XSetArcMode, XSetSubwindowMode, ......-2+6-. XSetArcMode(3X) 
XSetBackground: GC convenience routines. ......4.. XSetState(3X) 
XSetClassHint, XGetClassHint: set orgetclass ....... XSetClassHint(3X) 


XSetClipMask, XSetClipRectangles: GC convenience 
XSetClipOrigin, XSetClipMask, XSetClipRectangles: 


- XSetClipOrigin(3X) 
. XSetClipOrigin3X) | 


XSetClipRectangles: GC convenience routines. . . . 2... XSetClipOrigin(3X) 
XSetCloseDownMode, XKillClient: control clients. ..... XSetCloseDownMode(2 
XSetCommand: setcommand atom. .......-+ 2.6. XSetCommand(3X) 
XSetDashes: GC convenience routines. . .. 1... + + ee XSetLineAttribute(3X) 
XSetErrorHandler, XGetErrorText, . 2. 2 2s ee eee XSetErrorHandler(3X) 
XSetFillRule: GC convenience routines. . . 2... sees XSetFillStyle(3X) 
XSetFillStyle, XSetFillRule: GC convenience... 2... XSetFillStyle(3X) 
XSetFont: GC convenience routines. . . 1. 2 1 + se eo XSetFont(3X) 
XSetFontPath, XGetFontPath, XFreeFontPath: set, .... . XSetFontPath(3X) 
XSetForeground, XSetBackground: GC convenience . XSetState(3X) 
XSetFunction, XSetPlanemask, XSetForeground, ...... XSetState(3X) 
XSetGraphicsExposure: GC convenience routines. ..... XSetArcMode(3X) 
XSeticonName, XGetIiconName: set or get icon names. . XSetIconName(3X) 
XSetIconSizes, XGetIconSizes: setor geticon size ..... XSetlconSizeHints(3X) 
XSetInputFocus, XGetInputFocus: controlinput ...... XSetInputFocus(3X) 
XSetlOErrorHandler: default errorhandlers. . ...... XSetErrorHandler(3X) 
XSetLineAttribute, XSetDashes: GC convenience . ..... XSetLineAttribute(3X) 
XSetModifierMapping, XGetModifierMapping/ ...... XChangeKeyboardMapp 


XSetNormalHints, XGetNormalHints: set or get normal 
XSetPlanemask, XSetForeground, XSetBackground: GC 
XSetPointerMapping, XGetPointerMapping: manipulate 
XSetRegion, XDestroyRegion: create and destroy 
XSetScreenSaver, XForceScreenSaver, . . 2 2s + ee ee 
XSetSelectionOwner, XGetSelectionOwner, 
XSetSizeHints, XGetSizeHints: set or get window 
XSetStandardColormap, XGetStandardColormap: setor . . 
XSetStandardProperties: set standard window manager ... . 
XSetState, XSetFunction, XSetPlanemask, 
XSetStipple, XSetTSOrigin: GC convenience routines. 
XSetSubwindowMode, XSetGraphicsExposure: GC 
XSetTile, XSetStipple, XSetTSOrigin: GC convenience 
XSetTransientForHint, XGetTransientForHint: set or 
XSetTSOrigin: GC convenience routines. 
XSetWindowBackground, XSetWindowBackgroundPixmap, 
XSetWindowBackgroundPixmap, XSetWindowBorder,/ 
XSetWindowBorder, XSetWindowBorderPixmap: change/ 
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- XSetNormalHints(3X) 
- XSetState(3X) 
. XSetPointerMapping(3X 


XCreateRegion(3X) 
xsetroot(1) 
XSetScreenSaver(3X) 
XSetSelectionOwner(3X 
XSetSizeHints(3X) 


« XSetStandardColormap(: 


XSetStandardProperties(. 
XSetState(3X) 


. XSetTile(3X) 


XSetArcMode(3X) 


. » XSetTile(X) 
. XSetTransientForHint(3} 


XSetTile(3X) 


. XChangeWindowAttrib 
. XChangeWindowAttribu 
. XChangeWindowAttribu 


INTEGRATED SOLUTIONS 


/XSetWindowBackgroundPixmap, XSetWindowBorder, 
[XMoveWindow, XResizeWindow, XMoveResizeWindow, 
colormaps. /XCopyColormapAndFree, XFreeColormap, 
hints. 

hints. 

/XSubtractRegion, XXorRegion, XOffsetRegion, 
XRotateBuffers: manipulate cut and/ XStoreBytes, 
XFetchBuffer, XRotateBuffers: manipulate cut and/ 
XStoreColors, 

colors. 


XStoreColors, XStoreColor, 

XKeysymToKeycode: convert keysyms. 

utilities. XCreateImage, XGetPixel, XPutPixel, 
XShrinkRegion,/ /XUnionRegion, XUnionRectWithRegion, 
XPeekEvent: basic error handling. XFlush, 

synchronization. 


XQueryTextExtents16: compute or query text/ 
XQueryTextExtents16: compute or/ XTextExtents, 


XTextWidth, 

coordinates. 

XDefineCursor, 

XGrabButton, 

XGrabKey, 

XGrabKeyboard, 

manipulate the pointer. XGrabPointer, 
XGrabServer, 

install colormaps. XInstallColormap, 
XOffsetRegion, XIntersectRegion, XUnionRegion, 
XSubtractRegion, XXorRegion, XIntersectRegion, 
XSaveContext, XFindContext, XDeleteContext, 
/XLoadQueryFont, XFreeFont, XGetFontProperty, 
XUnmapWindow, 


XCheckMaskEvent, XCheckTypedEvent,/ 
XCreateBitmapFrom Data: manipulate/ XReadBitmapFile, 


/XUnionRectWithRegion, XSubtractRegion, 
XSetZoomHints, XGetZoomHints: set or get 


INTEGRATED SOLUTIONS 


Permuted Index 


XSetWindowBorderPixmap: change window attributes. . . . 
XSetWindowBorderWidth: configure windows. 
XSetWindowColormap: create, copy, or destroy 
XSetWMHints, XGetWMHints: set or get window manager . . 
XSetZoomHints, XGetZoomHints: set or get zoom state 
XShrinkRegion, XPointInRegion, XRectInRegion:/ 
XStoreBuffer, XFetchBytes, XFetchBuffer, ........ 
XStoreBytes, XStoreBuffer, XFetchBytes, 
XStoreColor, XStoreNamedColor: set colors. 
XStoreColors, XStoreColor, XStoreNamedColor: set 
XStoreName, XFetchName: set or get window names. ... . 
XStoreNamedColor: set colors. ... . : 
XStringToKeysym, XKeysymToString, XKeycodeToKeysym, 
XSublmage, XAddPixel, XDestroyImage: image .. . 
XSubtractRegion, XXorRegion, XOffsetRegion, . . 


eee 


XChangeWindowAttributes(3X) 
XConfigureWindow(3X) 
XCreateColormap(3X) 
XSetWMHints(3X) 

XSetZoom Hints(3X) 
XIntersectRegion(3X) 
XStoreBytes(3X) 
XStoreBytes(3X) 
XStoreColors(3X) 


. XStoreColors(3X) 


XStoreName(3X) 


. XStoreColors(3X) 


XStringToKeysym(3X) 


. XCreatelmage(3X) 
. XIntersectRegion(3X) 


XSync, XEventsQueued, XPending, XNextEvent, . ... . . XFlush(3X) 
XSynchronize, XSetAfterFunction: enable or disable . . . . XSynchronize(3X) 
xterm: terminal emulatorforX. .......+.+ +. +... xterm(l) 
XTextExtents, XTextExtents16, XQueryTextExtents, .. . . XTextExtents(3X) 
XTextExtents16, XQueryTextExtents, . . 2... 1 6 eo XTextExtents(3X) 
XTextWidth, XTextWidth16: compute text widthh ..... XTextWidth(3X) 
XTextWidthi16: compute text widthh .........62.. XTextWidth(3X) 
XTranslateCoordinates: translatewindow ....... . . XTranslateCoordinates(3X) 
XUndefineCursor: define cursors. . ...... =... +.» XDefineCursor(3X) 
XUngrabButton: manipulate the pointer. ......... XGrabButton(3X) 
XUngrabKey: manipulate the keyboard. . . ........ XGrabKey(3X) 
XUngrabKeyboard: manipulate the keyboard. .... . . . XGrabKeyboard(3X) 
XUngrabPointer, XChangeActivePointerGrab: ....... XGrabPointer(3X) 
XUngrabServer: manipulate the keyboard. . . . ... . . . XGrabServer(3X) 
XUninstallColormap, XListInstalledColormaps;: ...... XInstallColormap(3X) 
XUnionRectWithRegion, XSubtractRegion, XXorRegion, . . XIntersectRegion(3X) 
XUnionRegion, XUnionRectWithRegion, .......44.. XIntersectRegion(3X) 
XUniqueContext: manipulate the context manager. ..... XSaveContext(3X) 
XUnloadFont, XGContextFromGC: manipulate fonts. . . . . XLoadFont(3X) 
XUnmapSubwindows: unmap windows. ........ - XUnmapWindow(3X) 
XUnmapWindow, XUnmapSubwindows: unmap windows. . . XUnmapWindow(3X) 
XWarpPointer: control input focus. ..... =... =. . . XWarpPointer(3X) 
xwd: dump an image of an X window. . . . + « » xwd(l) 
XWindowEvent, XCheck WindowEvent, XMaskEvent, . XWindowEvent(3X) 
xwininfo: window information utility forX. ........ xwininfo(1) 
XWriteBitmapFile, XCreatePixmapFromBitmapData, .. . . XReadBitmapFile(3X) 
xwud: image displayerforX. 2... 2.6 2 ee ee eee xwud(1) 
XXorRegion, eet XShrinkRegion/ .... . . XIntersectRegion(3X) 
zoom statehints. . .. 1... 6 2 we eee Be ota setl See XSetZoomHints(3X) 
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1. X Window System Commands and Programs 


X ccoccecsensecseccesceccescesensceccecsccsccssecsecsscsessecsecessessecsessesseceesees X ~ & POFtable, network-transparent window system 
SEL VED, cccsscascsceosoecdssusesseecs voneseis sissosvsctevoasegnnesobepese staiseas éocacsecarcessshenserseevnuesessoeese 26 72s. WINGOW oYSlem Server 
WALITRAPD «ccs casccesccaoscuedevs enicoaccaessucesessacsssscaosteacaiee tgidcasacconsecce mnetese ter vesnesa mony erceam aeecemenmeaae OLEMAD COLOr 100 2c 
ICO ccccccoccscceccoscosccsesesccsesecscecscescesssoscesssessessssseessesssscsssscessosesseceseees AlliMate an icosahedron or other polyhedron 
MUMNCHET ...cccocsorercsccseceecescsccescsecsesoscnscessscescsesescessessessessossoseessesseeees CLAWS interesting patterns in an X window 
Plaid ......ccccscrecscessececessecessecsscecsassccsessecgeseccrssvesesessesssessesesseesvees Paints Some plaid-like patterns in an X window 
DUZZIE sescccescusstscesaveceas eouceseubaseessdeddeocnessecncteodse teossbesesssasseenaetionbossens taasoose taassboneessaseeasiaess 1)" PUZZIC Paine 1Or 2 
LWIN .ccccccccscccccecceorecccsecccssseccccssesessesssscsscesceevers LW - 2 Window manager for X11 (Tom’s Window Manager) 
LEWIN cssssceiaccscecssenasusesceccansovssacssviseadeesestuscaencsssessoescetbecdesceastussbssssasadedesteosenioss ceossacereeses @ WIRKOW Manager for. 
WIM scocscccorsocacserscesceccsssocsacseseesecsescaseosoceesensecsssssscssscssessessessscesessess & SiMple real-estate-driven window manager 
X1OtOX1 1 .....cccccccscsseccssscesscscsescscsssesorsscccsessessessessssssensessenseeasesre & Version 10 to version 11 protocol converter 
K DIED secccsuctuescacesus sebossscosveacseussceasseostecesssencéupsassoseasensecesveastieshavecteetasselesescnacscésecassachiervecisestames MALLODOK L109. 400 
NCIC <iicassesancxasnsdicodndanccoecsesescessacsvosss coacssatecsconsassendeaseaneaiduaresseusaseicasssausaabciseisadeiseriestss SCIOHUNC Calculator Or X 
ACLOCK cacscdesacecescccctcccheeiocossvcsiesaveascesecsteseskconesssskegsansseborapscesectassesesdeuaesneaitsussnnasese ANOLON / Glpitnl ClOCK for X 
XPT .ssccscosorcesecceccscsesessecsscoroescescesssssssesessesessesecsessesessessovessesesseseesoeees GUMP aN X window directly to the printer 
NOCIE scsccnssseconiccccaawsecdscpsensacsesiencoudssdscdedved endsedsea peesescsadbatibanh etes seceesesentaedcccatasbeuse aisadaede SlMpIe 1eXt COlior for X. 
HE ccsiscssiiicndascatedscadcassecssssesssscsiceibcicsacscalpucasededsus sbislaesdassebsdebs satéassssssduscsedeshscrestoesussousvioisdses LON CISPIAVET (Ol. 
ROSE sscsdesssesssvanyscacsace cchcudscevedscdebnsecods censeasoasseccuasssncsssesdededebsnssesesesbasedusseen SELVEL ACCESS CONHOL program for X 
NINE ciscecdcnesssccoascsccesccsesscscsesesbose snssnoesesenseaeseserusstenassoseseteneacsisndsdcancsotecsspeitensscas  WINKOW OYSICMI INIlaliZer 
MIS eschessiessvesosdactessessiad sedecovsiaseussaaplueisacansatscciacseotslacastosnsceveusbusidessuabesyidsshcatensivecsesdeaatstsssesaiacieute BELVEE 101 Ack 
NIDA secccscncdscieevescswsa ceconscbsccescecwes sates vavsboseecndseiwessecsas snbeipseensa esas oveaeensbetesksebescsectevencés LOAM AVEeLage CISpiay Tor X 
MIODO sssssssducsvicbessvessstasessdcovsasssnceacesescacsasacacdusdebavsbesncsscsucststadistsssasesoasteidesennmuassageniaias ok WINGOW DySLCM 1020 
MIS LOMES: 2c. ssccscsessessadvgnasiancaiica vacgandcnceeavcatescasendecbassedassbessaaabesdduesbecetecoattensessesseess SCEVEE LONU LISLE Gisplayer for. 
XIMN .sscsscecccsscecescscccccccsescescsecsnsscessecessescsesensessocssssecsesensseseesessesseses X WINdOW interface to the mh Mail Handler 
AMOGIMAD - secoscescscecenvasessssncevssessessssssecopssvoenssecseod sseasscccecsoensesnecssdveensseciconvesensce KEY DOGIG. modifier utilities for X : 
NPT cose cdpcasaciss scabeasca dostncapesantacetcancassess celesbianlsstateudssessausessiceiersessasstn aie asssvenemens PHINE all oe WINdOW dump 
ADPKD 52a. sccincssescsscnosenccsccesvexsoecsssedcosSenksncssasavdversopascavsaiseseneresseasestuiscusevecnsens ROY DOATG. MOU lier uprlitres for X. 
ALO sseoccstseasctesavcosenssphocsceats cpasncenpiensicednssenchbuteacecsesesbaassoutsndas oes sossnscspssdaesousessesscecsssssncs PLODEILY Gisplayer [or 2. 
ALO sss sascacieeacscensscessceaswscsssucavin siavaesechusccses eadateseeasteesacensecassatensetea céokasdadebase an Sea VEL LeSOUrCe Galabase MULILY 
RHCLTCSIN :ssarseiceansisacascranacccceves svestavasaesnosbassacsessts oedsecssecsensenebetenseerstesbsviesetvaniese FELLeSU all OF part Of an X screen 
RSEL ‘cs sscshacassseccecsedaccdusmicecstasnasassessdensssscdawadasognadncesiecensestscess destesapssbassccassauassarson USEr Prerercnce utility for x, 
XSCUTOOL ..rcccccccreccscceesersseescoscessscorcssscessescsessesssssescessessessssesssessessees FOOL Window parameter setting utility for X 
KUCTENL-sisseccsccesssscectsceseanecbngace de caceoceavesspecesesovevecsseseavesss oeensctesedesublon sgueanceosevsslespiecseinrene TETMIMAL OMULALOF LOF 
XW. scssssscccosecsssardeseinenesss cesses encasoscecnescnssestousedecesbobastesens eeddeosneneobessenneeietsevniess CUIND AN image OF an % window 
A WINN ‘sciccorscoesccscocscosevecosnessesscsnseseionsonssvereccevedbeissoosseeetecoesestecenicetsessorveteess WINCKOW Information uliity for X 
RWG “svccssccdetsssstcesceseshsssteusdaansctachasvescsicadessicelenciiestéuteusecanets torte sasencoacsteassesbesiocaterneneiweaeiillage Cisplayer 106%. 


3X. Xlib Routines 


KAUCHOSE csi cscvinssetenseaukostesessessenassdesscses sosasvesuessss vhost ensosassacetsaksosacsoeadasesgasbebsssseispsausssasseseniy: COMILOL NOSE ACCESS 
PALOCCOIOR ’ csszccsssccsasocssosstsn caaesdsoseaesoowscdatesoesses soasresbeesnsusnecicdaressatieasigunia tesstbgmsassvnseiss BLOCAIE ANG L166 COLOS 
XAIIOWEVENES .ssssoscossesssorenceecsessessosesssessescscsccesconsorsesessessscossoscscssessesseesessesoes CONLiNUC frozen event processing 
XChangeKeyboardControl ..........esecccssscrscessssersssecesccsscsescesscsessessesssssssesseseeeeeees Manipulate keyboard settings 
XChangeKeyboardMapping ......01crcrsssccsssscecseseecesssssecsvscecsesseessccsessesseceeeeerre MANipulate keyboard encoding 
AChangePointerContrl seicrerecnscsenrsascoscsssderssrssnssssoosocoreevercessssscnesecsseasscoes secssessesensssaveeesecsssossonsss CONITO! POINTET 
ACNANTESAVESEL :s.susssccsecsvencensacceebsceceshshcconesetoposeand dasnbeversbasdscedebobabssetasonnbosaseissessesiees CHANGE @ ClICnL S SAVE Set 
XChange WindowAttribute ........cccccccssccsessccssssscesservessecsersersecsessessessessvessesesseeseoseers Change Window attributes 
PCICOLATCA sccesssecechscansscnssdspvachastcetsuelgesndeansoessascdase vane busadssasnasbaaphaseassspates ents Sealeasveheseitatseasscsieiesess CLCAD WINGOWS 
MCONA SUPE WINGOW scccsccssccsnscasessenschcentesdensonsvensceasd osucseicenteasecsosccsvextcdssccbsecsednassbieisesseasesises COMPUTES WINGOWS 
MCOPVALER  cisisssiccssscdcvkecstessvissuasustocvsieoucses sebeucsoasases cosanstisaus tosasasedobsedeasedsessniatabeesniecananeds lensemaeianiacs COPY AlAs 
XCreateColormap «..cccccsocrcsscversecseressoccersesvescecerssecsecescesceessesessessvessessessesoes CLEALC, COPY, Or destroy colormaps 
XCreateFOntCursor ....r.cccccsccerecssececersecessecessesscecseencsssesscesocensasocoesnsnsssssecssessssorsssesssessssesesesssssseses CLEALE CUFSOTS 
KC reateGC .c<ceccovsscesscoonssiosessocessridennseassosnssstssnseisecdseasesdussesevasssesarssaiecssseesscess Cheate and free graphics coritexts 
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MCTOALCIMA LE <<ciscccuscascaseies sasosieossanesensesalocnsayeceeveanseettas ceestesashossoaadte satsasevaesesesovesscussosteatoessetacsees IIDARC UUUGES 
KCTEACPIXINAD csncrsscccssecssesoventoereveocechendvessscetacnsbasssnsenssarsonses sgndeeseusestestecssaseacceres CTCALE ANG GESITOY PIXMAPS 
K CLERIC REGION csc scccccustecesecesdavesunenosnssasvecessncanesuesabesenstesnveg seeteuesdestectioeseesonseasnoscesenee CleAle Ond GesiOy TEGIONS 
XCreate WINdOW ...eccoccsecsecoserercessesseccvecnsttsvoseesenses stent cesousnavessossooveesevenseconsssesessonvesosessessessossesors CLAS WINGOWS 
PEDIC MOC UTS: ss ccsssoisceciceccccnscesossncyaasacs sbbsscots sie teaiebvespke boenesbadessenbecopesesstonveos sostseaeeuveieseseveensene CCUDIS CURSOIS 
MR DESIOY WINGOW vecseccscsaviscccs coscscssensoonsosbusesusousedebeces0es codedeecsebssovssusonisasassvessesseenssoonstameniesets GESILOY WiLLGOWS 
A DIAWAIC sscissccsccseesssccacscaceasexcuucsussensansensaceseioeusacasssbssisesdsbes tbnessntuesbavceseiveakosansavsksesasdostecessetenrasrteces LAW. AICS 
DPW IMAGES WING .sicsceshcissdacececosesacestuctossesacensdescessstydeasesssusstesseens coaseseea seatvensocatessoassbeasteosoness UTAW IMlage text 
PDA WINE -catucsccusssssceccecsedvecttcnsss¢ecesnios coved eogevsndsoeseseuspaabessenee taveesedaesesgeateesstéssssionseoes LAW. LINES ANG POLYZONS 
A DIAWPOMI: <psiciascessevcecaconscacssedcesssbcveavescancssisensoesecssuruasesanvbesateacesiedecerbassodehassevises shoud Ghiseeussessesiosss CLAW POLLS 
MD FAWRECCAN GS -c.ciccsssesssssvesendsencavassensaasedssrsyqubs ines desieaeate sot cansbentussatess sbeseonstesesbbisaosensuentnnncss CLAW FECLANGICS 
PRDDUAW SWING assists scccecascassbescasdessescnineseoseseusesnauvsususd epkacstcevaeessbesbeneseenseteatascesaracemspusiauetin OLAW leXL Characters 
PELTAW TERE sasasiccccentusicve cococessnnvossasaensastsinteeta nis ivessensacseutsiasioecsecs benbsussbe ce uesas cates easveebentelacecsinese CLAW POLYLEXC (EXE 
XEMPtyREZBion .......ccccccocssorscescsesseressescessossessscsessersessessecsoesesseessessesees Getermine if regions are empty or equal 
AFR ECtAN BIC scscsssencosecsencessocusessssssceassrensseseesscasesvecsbebessesosespnestabspeosessssseoseees LL TECLAN Pes, polygons, Or arcs 
KFIUSN - ssscssssccsossssscceacsssecscsccesesassesceosesesestiseseasesaes obcseassensecsseseesetessisnssensssiessssotesesssensassessers DASIC Error handling 
DP ICE nsccccssncssscscetsiascsstbeisatariaciactasaassesssvapasiudcsvedicssdisiesdsbasusausiensdsoasssuscserstcubeasmsssatbsess teissesvescassees ATCO CHEN data 
MGEIDOLAUIE: -<cccsinaziscciavacsoscscosasatersessensvesassccescks tered aobadseasasseasiussosnssiesgebenieapsesteccoiatoneaess’ DOU.2s DrOgTam Celaults 
XGetVisuallMfO ........cccccccccscccccescecscsererescessecesessesercesseessscecsveccsessescossesssseseeresseceereesers OMAN Visual information 
XGetWindOwAUributtes .......c..ccccresrccsscscressecssssssesecsssscssessecseeoseessens PEL Current window attribute or geometry 
XGetWindOwPropEerty .......ccccccersscccrsceseesveresessesssecerereesseessvecsesseeseoeseeees ODLaiN and change window properties 
AGLADBUUOM: :csscsecaseccosencsessosesovsscuscetsicatasdstcavoosepate esbvoces soseteaavees Picesesiesnessasdesoreneuess INADIDULALe LNG Pointer 
MGTADK CY arissccsstcdssinsiscotinceiecds sbieasactnvasicseibareasekevint ska tsticeteedsionien nisesvuanmins MalDuUlate the keyboard. 
PGTADK CY BOAT snccsccscoccssescassossodsonssosensessssasesespeselapequanevesssensbieassstesvevesesseceetivennsinetesess MAID ULate the keyboard 
PRGTADP OME? ‘scccisevecsccsucsscacesaahigiccusseossccdupebescaseenccets naaaecs svete selma easeassolenieoresentueanienue MANIDUAte Le DOINIer 
MGTADSCLVER -sccossccscasscsssssocensocncdsaveshossbsnntes eotatebesedssasestegassies eantecssaancesasertelecspessteseacses MAIDUlate the keyboard. 
PIPE VEIL sccsicescssscoscsscaatennssoaresnissceaeabpsosscudousescaptuatesbesicscteassecs inodessaasss sosepeabensneecsenteseesecens CHECK [ie event queue 
AIMStALIC OLOMI AP: <ccsusscassssacosessseccassosisesssesnns osnsacesessausssiones coctesadsbsasecsenseseosessessetenesscsedesossscsseee LSTA: COLOFMADS 
AIMISIMA LOND: scssessccnjsscoesnaieceensseacecotascsssnssssaseadossenassidheaas cisoessuabsuasdiveseescoscsnebssenee CLOALE ANG TeLUIM Atom NAMECS 
MIMISTSECHRE BOM ss. sstacsessseesscssessscdsorssoibesnieassnsessaces tu vsnsouseasedsetenstsencsbs adecsssssssdstantesssssseessasases TEPION ANILMIMELIC 
XLIStFOMIUS is.secconcstssesseeonsssossosassesssboonsassensiutucutescesid es sassdeisedesceutivsvebsteotiediocessvessnae OOlaIN and free font names 
PLOACFONE | scscsssccsscsascsses netsasectecasessesepoosactasssavoncccivesteseensnseuanscseessseseseteasesesesssesscssohoseeteasestsosvees DMANIDULAtS TONES 
' KLOOKUPKEYSYM ....cccccossccsvsovsersessevsecsoecscessecsessearenssecsveescesseccecssossscescessessssseeseess Handle keyboard input events 
IMAP W INOW sscvccccviscocsssdsndescectecsconsnsondesescnteedssaesadeses asaeeoseensossecssepesaesoustorscesstosetesseaseesosgessvecoses ILAD. WIMOWS 
XOpenDisplay ....cccccocecccescaccccsccsescessscssesressescocsesaacsessacscossesrescesosoversssosesseee CONNECE OF disconnect to X server 
XPaArscGOMEITY .....cccrccccccereccerscssserssecsssessereresseceseersssoressesesseossoesesserssssseees Parse Window geometry and color 
KPOLYROMRE ION cscs ccisoensccesticencssnsensesiceseses4ossossecednsin toeateessuavedeace stapnasersuersicetaceietstreostnaneier Lenerale TECIONS 
XPUuULBACkEVENt .....ccrssrerocovssoasenessnnsessssasocsssessoesoesoverssssonssesssessessacssessssooseessesooreees PUL EVENS back on the queue 
MPULLMAGE:. sasscesevsavcdsceisenceccecevoceeteaseungnssesbscdsisasanavcnetesevveisessienboehecevevascsensounine cored sesheesesetsistoomyes’ LaNSLeT UNales 
MQUEFYBESISIZE scccsscesnsscccestenscasedouted esecsovescechessossscunsssus ousnbbeveses seussenecesseseeasseasancaceies USTETMING CLCICNt Sizes 
PRODUCE YC OOM” secs acces cacsace sackacisaiessns coahoavosessusen sobivosssaian cease sacs denstassuaneicqsiedstusmesvasentinstesconed OOLAINY COOL Values 
MOQUErYPOMMNIEL acccissscscessinscssiesessesnnsdsseseusdesansnnesossiencouvosobbi iulnsssacvesaseisberomaresoancesicieasecs BEL POlTteT COOTCINALES 
PQUETY TICE: cccsccssscesscsersscccessccsececscesensssustesnvedeseotsesaceacssssnsocsosdseansoancinvesssuecmee QUELY Window tree Information 
XRAISCWINGOW ....ecccrorecccrscrssvsoreccssssescsasceccvscscsssareessesevesssessescosssossosscsssseseesseerse Change Window stacking order 
ARead Bitmap ile s.sccsc.cecccicts<cacsessessesesassnnseseisccsscdn iechcasscneceessadbsesseesacecssessesssstsctssumsoesessees MApUlate DItMApS 
MR ECO CUISON .ssssdscscbscsacesSccesadis plsausnbinsinsecnscsossacecsasevonnsbaksduasssasishacesstsedesns sisbeceonassssetscoses ANAM PULALS CULSONS 
AREDATENEW INDOW  ccccscosccocssasendsscstcedacossisicessencenanessee snscu oedson scosobinas seesscdsapsssesedtosacsabssoescsesses TEPATONL WiNUOWS 
XSAVECOMNIECKL ....coccsscsveesceerscocseccsceerecscerseeseevenssesssesseessvesocoseososesseesesssessescconve Manipulate the context manager 
A SCICCUNDUE sisscocccccecsscsosessssvcsdsdecesecsbacsosesssvendecdicrsesidnccteseaubsbebsbacdenessbenssesscksesenemacientoesnies SCLOCE INDUL CVENES 
IRSCLATC MOE: cesscesiecacscencastassdascnssesateasausss tostagbecnsusoisdsiassdescbeneteasesieqssscicbsesntestsssocsese WIG CONVENIENCE TOULINES 
MSC tClASS HIN -<ssssccsssveciucasauts capssceneccasenss ouechconsdossnvassscedvssesevsssat esouv saute cevssneoutencevemenrsiecesize SOL-OF BEL ClASS hint 
MSEWCIPOTIGIN se ccvrsicscsiccnsesssncesetosdven sed ekicndascussusebe ieee ieandssacesssenes dbssabivossenissessobeusssacss. GOK CONVENIENCE TONNES 
MSEtClOSEDOWNIMOTE cissccissscessiensetenssics séatennsed anh sasaasnca ssa ssieedeisssdesonacenssagndnavensiacs céaesessascsenddaenees CONUOL CLIENTS 
PROCICOMIMANA > ssccscosoccasensscensscededsbascosucaasonasasvaceasiaseostabeai sooiessavebsedsosacs coussonssiotoscessasossnestiess SEL COMMANG BLOM 
ASCE IMOPH ANIC csccscssccesssscccsisnasedesesssossdevnstn sesansecodesuseveadorvbsves sosencessestasedeseesovecneaseseses, OOLAULL EJTOR NANGLETS 
PRSCUPUIS VIE: <scscessncesactvessesseckccsescestassastecusisasespaiva ceses cicks shatshesssctssesstaeastessasvasssmiaas I CONVENIENCE TOULINES 
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TRS GLP ONL: cs ssecceceshes condesessencadsnacediesesse dese sheceidacsosessasesguataussbies oancetasterisabeseecateaaceaneassiaas OC CONVENIENCE TOUTINES 
XSEtPONPAI: «-ccssececosersseessonsssnnsascossncescsectenstsonsossetsssaseasssessetssesesssneassioesene SEL, PEt, OF free. the font search path 
PR SCECOMNAME ccccscscececessssesnesasiesescsesatondeseedons tava ticvececoeteeostedcaeers ecapesverssvessneascensoosnasidesess SELOF BEL ICON NAMES 
MSCtICONS ZEIMS: :cissscessscssssdsseoseosaseciccoosnen ceckesasssrssnrsecsoavenessscsostoasoadescossspesssessenoeesesse’ SEL OF PEL ICON Size hints 
SEU PutPOCUs siccscasescacioseccoedecnsceccesasesssterasoeinescasonetbconstedccnssessssisedsosccaseiasqevetosssastigaseionscce CONMOs INDUL LOCUS 
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NAME 
X - a portable, network-transparent window system 
SYNOPSIS 
X is a network-transparent window system developed at MIT which runs under a wide variety of operating 
systems. The standard distribution from MIT works on Ultrix-32 Version 1.2 (and higher), 4.3BSD Unix, 
SunOS 3.2 (and higher), HP-UX 6.01, and DOMAIN/IX 9.7. In addition, many vendors support the X 
Window System under other operating systems. 
THE OFFICIAL NAMES 
The official names of the software described herein are: 
xX 
X Window System 
X Version 11 
X Window System, Version 11 
X11 
Note that the phrases X.11, X-11, X Windows or any permutation thereof, are explicity excluded from this 
list and should not be used to describe the X Window System (window system should be thought of as one 
word). 
X Window System is a trademark of the Massachusetts Institute of Technology. 
DESCRIPTION 


X window system servers run on computers with bitmap displays. The server distributes user input to, and 
accepts output requests from various client programs through a variety of different interprocess communi- 
cation channels. Although the most common case is for the client programs to be running on the same 
machine as the server, clients can be run transparently from other machines (including machines with dif- 
ferent architectures and operating systems) as well. 


X supports overlapping hierarchical subwindows and text and: graphics operations, on both monochrome 
and color displays. For a full explanation of functions, see the Xlib - C Language X Interface manual, the X 
Window System Protocol specification, and various toolkit documents. 


When you first log in on a display running X, you are usually using the xterm(1) terminal emulator pro- 
gram. You need not learn anything extra to use a display running X as a terminal beyond moving the 
mouse cursor into the login window to log in normally. 


The core X protocol provides mechanism, not policy. Windows are manipulated (including moving, resiz- 
ing and iconifying) not by the server itself, but by a separate program called a ‘‘window manager’’ of your 
choosing. This program is simply another client and requires no special privileges. If you don’t like the 
ones that are supplied (see uwm(1) and wm(1)), you can write your own. 

The number of programs that use X is growing rapidly. Of particular interest are: a terminal emulator 
(xterm(1)), window managers (wm(1) and uwm(1)), a mailer reader (xmh(1)), a bitmap editor (bit- 
map(1)), an access control program (xhost(1)), user preference setting programs (xset(1), xsetroot(1), and 


xmodmap(1)), a load monitor (xload(1)), clock (xclock(1)), a font displayer (xfd(1)), a protocol translator 


for running X10 programs (x10tox11(1)), and various demos (ico(1), muncher(1), puzzle(1), etc.). 


DISPLAY SPECIFICATION 


When you first log in, the environment variable DISPLAY is set to a string specifying the name of the 
machine on which the server is running, a number indicating which of possibly several servers to use, and 
possibly a number indicating the default screen of the server (usually this is omitted and defaults to 0). By 
convention, servers on a particular machine are numbered starting with zero. The format of the DISPLAY 
string depends on the type of communications channel used to contact the server. 
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The following connection protocols are supported: 


TCP/IP 
DISPLAY should be set to host:dpy.screen where host is the symbolic name of the machine (e.g., 
expo), dpy is the number of the display (usually 0), and screen is the number of the screen. The 
screen and preceding period are optional, with the default value being zero (0). Full Internet 
domain names (e.g., expo.ics.mit.edu) are allowed for the host name. 


Unix domain 
DISPLAY should be set to unix:dpy.screen, where dpy is the display number and screen is the 
screen number; screen and the preceding period are optional, with the default value being zero 
(0). 

DECnet 
DISPLAY should be set to nodename::dpy.screen where nodename is the symbolic name of the 
machine, dpy is the display number, and screen is the screen number; screen and the preceding 
period are optional, with the default value being zero (0). 


Most programs accept a command line argument of the form ‘‘-display display’’ that can be used to over- 
ride the DISPLAY environment variable. 7 


GEOMETRY SPECIFICATION 
One of the advantages of using window systems over hardwired terminals is that applications don’t have to 
be restricted to a particular size or location on the screen. Although the layout of windows on a display is 
controlled by the window manager that the user is running, most applications accept a command line argu- 
ment that is treated as the prefered size and location for this particular application’s window. 


This argument, usually specified as ‘‘-geometry WxH+X+Y,’’ indicates that the window should have a 
width of W and height of H (usually measured in pixels or characters, depending on the application), and 
the upper-left corner X pixels to the right and Y pixels below the upper-left corner of the screen (origin 
(0,0)). ‘“WxH’’ can be omitted to obtain the default application size, or ‘‘+X+Y’’ can be omitted to obtain 
the default application position (which is usually then left up to the window manager or user to choose). 
The X and Y values may be negative to position the window off the screen. In addition, if minus signs are 
used instead of plus signs (e.g., WxH-X-Y), then (X,Y) represents the location of the lower-right hand 
corner of the window relative to the lower-right hand corner of the screen. 


By combining plus and minus signs, the window may be place relative to any of the four corners of the 
screen. For example: 


S55x333+11422 This will request a window 555 pixels wide and 333 pixels tall, with the 
upper-left corner located at (11,22). 


300x200-0+0 This will request a window measuring 300 by 200 pixels in the upper-right 
hand corner of the screen. 
48x48--5--10 This will request a window measuring 48 by 48 pixels whose lower-right 
hand corner is 5 pixel off the right edge and the screen and 10 pixels off the 
bottom edge. 
OPTIONS 


Most X programs attempt to use a common set of names for their command line arguments. The X Toolkit 
automatically handles the following arguments: 


—bg color, —-background color Specifies the color to use for the window background. 
—bd color, —bordercolor color Specifies the color to use for the window border. 
—bw number, —borderwidth number Specifies the width in pixels of the window border. 
—display display Specifies the name of the X server to use. 

—fg color, -foreground color Specifies the color to use for text or graphics. 
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—fn font, -font font Specifies the font to use for displaying text. 

—geometry geometry Specifies the initial size and location of the window. 

—iconic Indicates that application should start out in an iconic state. Note that how 
this state is represented is controlled by the window manager that you are 
running. 

—name Specifies the name under which resources for the application should be 


found. This option is useful in shell aliases to distinguish between invoca- 
tions of an application, without resorting to creating links to alter the exe- 
cutable file name. 


—rv, —reverse Indicates that the program should simulate reverse video if possible, often 
by swapping the foreground and background colors. Not all programs 
honor this or implement it correctly. It is usually only used on monochrome 
displays. 


+Irv Indicates that the program should not simulate reverse video. This is used to 
override any defaults since reverse video doesn’t always work properly. 


—synchronous Indicates that requests to the X server should be sent synchronously, instead 
of asynchronously. Since Xlib normally buffers requests to the server, 
errors do not necessarily get reported immediately after they occur. This 
option turns off the buffering so that the. application can be debugged. It 
should never be used with a working program. 


—title string Specifies the title to be used for this window. This information is some- 
times used by a window manager to provide some sort of header identifying 
the window. 

—xrm resourcestring Specifies a resource name and value to override any defaults. It is also very 
useful for setting resources that don’t have explicit command line argu- 
ments. 

RESOURCES 


To make the tailoring of applications to personal preferences easier, X supports several mechanisms for 
storing default values for program resources (e.g., background color, window title, etc.) Resources are 
specified as strings of the form ‘‘name*subname*subsubname...: value’’ (see the Xlib manual section 
Using the Resource Manager for more details) that are loaded into a client when it starts up. The X/ib rou- 
tine XGetDefault(3X) and the resource utilities within the X Toolkit obtain resources from the following 
sources: 


RESOURCE MANAGER root window property 
Any global resources that should be available to clients on all machines 
should be stored in the RESOURCE_MANAGER property on the root win- 
dow using the xrdb(1) program. 


application-specific directory 
Any application- or machine-specific resources can be stored in the class 
resource files located in the XAPPLOADDIR directory (this is a 
configuration parameter that is /usr/lib/X11/app-defaults in the standard dis- 
tribution). 


XENVIRONMENT Any user- and machine-specific resources may be specified by setting the 
XENVIRONMENT environment variable to the name of a resource file to 
be loaded by all applications. If this variable is not defined, the X Toolkit 
looks for a file named .Xdefaults-hostname, where hostname is the name of 
the host where the application is executing. 
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—xrm resourcestring . Applications that use the X Toolkit can have resources specified from the 
command line. The resourcestring is a single resource name and value as 
shown above. Note that if the string contains characters interpreted by the 
shell (e.g., asterisk), they must be quoted. Any number of —xrm arguments 
may be given on the command line. 


Program resources are organized into groups called “‘classes,’’ so that collections of individual ‘‘instance’’ 
resources can be set all at once. By convention, the instance name of a resource begins with a lowercase 
letter and class name with an uppercase letter. Multiple word resources are concatentated with the first 
letter of the succeeding words capitalized. Applications written with the X Toolkit will have at least the 
following resources: 


background (class Background) Specifies the color to use for the window background. 
border Width (class BorderWidth) Specifies the width in pixels of the window border. 
borderColor (class BorderColor) Specifies the color to use for the window border. 


Most X Toolkit applications also have the resource foreground (class Foreground), specifying the color 
to use for text and graphics within the window. 


By combining class and instance specifications, application preferences can be set quickly and easily. 
Users of color displays will frequently want to. set Background and Foreground classes to particular 
defaults. Specific color instances such as text cursors can then be overridden without having to define all 
of the related resources. . 


When a named resource is unavailable (for example, a color named chartrusse or a font named teeneywee- 
ney), normally no error message will be printed; whether or not useful results ensue is dependent on the 
particular application. If you wish to see error messages (for example, if an application is failing for an 
unknown reason), you may specify the value ‘‘on’’ for the resource named ‘‘StringConversionWarnings.”’ 
If you want such warnings for all applications, specify ‘‘*StringConversionWamings:on’’ to the resource 
manager. If you want warnings only for a single application named ‘‘zowie’’, specify 
“‘zowie*StringConversionWarnings:on’’ to the resource manager. 


DIAGNOSTICS 
The default error handler uses the Resource Manager to build diagnostic messages when error conditions 
arise. The default error database is stored in the file XErrorDB in the directory specified by the LIBDIR 
configuration parameter (/usr/lib/X11 in the standard distribution). If this file is not installed, error mes- 
sages will tend to be somewhat cryptic. 


SEE ALSO 
xterm(1), bitmap(1), ico(1), muncher(1), plaid(1), puzzle(1), resize(1), uwm(1), wm(1), x10tox11(1), 
xbiff(1), xcalc(1), xclock(1), xedit(1), xfd(1), xhost(1), xinit(1), xload(1), xlogo(1), xIsfonts(1), xmh(1), 
xmodmap(1), xpr(1), xprkbd(1), xprop(1), xrdb(1), xrefresh(1), xset(1), xsetroot(1), xwd(1), 
xwininfo(1), xwud(1), Xserver(1), biff(1), init(8), ttys(5), Xlib — C Language X ae X Toolkit 
Intrinsics - C Language X Interface 


1 September 1988 INTEGRATED SOLUTIONS . 4 


XSERVER (1) X Window System Reference Manual XSERVER (1) 


NAME 


X - X Window System server 


SYNOPSIS 


X displaynumber [-option ... ] ttyname 


DESCRIPTION 


X is the window system server. On operating systems derived from 4.3BSD, it is run automatically by 
init(8), otherwise it is started from the xinit(1) program. The displaynumber argument is used by clients in 
their DISPLAY environment variables to indicate which server to contact (large machines may have 
several displays attached). This number is usually in the range of 0-6 and is also used in determining the 
names of various startup files. The ttyname argument is passed in by init and isn’t used. 


The executable that is invoked when X is run is actually one of a collection of programs that depend on the 
hardware that is installed on the machine. Any additional features are described in the documentation for 
that server. 


The sample server has support for the following protocols: 


TCP/IP The server listens on port htons(6000+N), where N is the display number. 

Unix Domain The file name for the socket is X_UNIX_PATH* where X_UNIX_PATH is a 
configuration parameter (/tmp/.X11-unix/X in the standard release) and ‘‘*’’ is the 
display number. 

DECnet The server responds to connections to object ‘““X*’’, where "*’’ is the display 
number. 


When the sample server Starts up, it takes over the display. If you are running on a workstation whose con- 
sole is the display, you cannot log into the console while the server is running. 


OPTIONS 


The following options can be given on the command line to any X server, usually when it is started by 
init(1) using information stored in the file /etc/ttys. (see ttys(5) for details): 


—a number Sets pointer acceleration (i.e., the ratio of how much is reported to how much you 
actually moved the pointer). 

—C Turns off key-click. 

c volume Sets key-click volume (allowable range: 0-8). 

—f volume Sets feep (bell) volume (allowable range: 0-7). 

—logo Turns on the X Window System logo. display in the screen-saver. There is 
currently no way to change this from a client. 

nologo Turns off the X Window System logo display in the screen-saver. There is 
currently no way to change this from a client. 

—p minutes Sets screen-saver pattern cycle time in minutes. 

-r Turns off auto-repeat. 

r Turns on auto-repeat. 

—S minutes Sets screen-saver timeout time in minutes. 

—t numbers Sets pointer acceleration threshold in pixels (i.e., after how many pixels pointer 
acceleration should take effect). 

—to seconds Sets default screensaver timeout in seconds. 

v Sets video-on screen-saver preference. 

-Vv Sets video-off screen-saver preference. 
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—co filename Sets the name of the RGB color database. 
—help Prints a usage message. 
—fp fontPath Sets the search path for fonts. 
—fe cursorFont Sets the default cursor font. 
—fn font Sets the default font. 
Specific implementations may have other command line options. 
RUNNING FROM INIT 
On operating systems such as 4.3BSD and Ultrix, the server and your login window are normally started 
automatically by init(8). 


By convention, the pseudoterminal with the highest minor device number (e.g., /dev/ttygf and /dev/ptyqf) is 
renamed for the lowest display number (e.g., /dev/ttyv0 and /dev/ptyv0). Machines that have more than one 
display can repeat this process using ttyge for ttyy],andsoon. — 


With this done, you can set up /etc/ttys to ran X and xterm by adding the following entry (the \’s is to make 
the lines fit on this manual page, the real entries have to occupy just one line): 


ttyvO "/etc/xterm -L -geometry -1+1 -display :0" xterm on\ 
secure window="/etc/X :0 -c -1" 


on the client machine. 


Important note: some versions of init have relatively small program name buffer sizes, so you may find 
that you can’t list many xterm options. In addition, some init’s will treat the sharp signs that are used in 
specifying colors (such as for window backgrounds) as comments for the whole line. If you run into prob- 
lems such as this you may want to write a small program that just exec’s xterm with the proper arguments 
and have init run that instead. 


If all else fails, set the display up to be a dumb terminal and use the xinit program after logging in. 


SECURITY 
X uses an access control list for deciding whether or not to accept a connection from a given cleint. This 
list initially consists of the machine on which the server is running, and any hosts listed in the file 
letc/X*.hosts (where * is the display number). This file should contain one line per host name, with no 
white space. If a name ends in ‘*::’’, it is assumed to be a DECnet host, otherwise it is interpreted as an 
Internet host. 


The user can manipulate a dynamic form of this list in the server using the xhost(1) program from the same 
machine as the server. 


Unlike some window systems, X does not have any notion of window operation permissions or place any 
restrictions on what a client can do; if a program can connect to a display, it has full run of the screen. 
There is support for using authentication services on connection startup beyond the simple host name 
check, but it is not used in the standard distribution. 


SIGNALS 
X will catch the SIGHUP signal sent by init(8) after the initial process (usually the login xterm(1)) started 
on the display terminates. This signal causes all connections to be closed (thereby ‘‘disowning’’ the termi- 
nal), all resources to be freed, and all defaults restored. 


DIAGNOSTICS 
Too numerous to list them all. If run from init(8), errors are logged in the file /usr/adm/X*msgs. 


FILES 
/etc/X*.hosts Initial access control list. 


fusr/lib/X11/fonts Font directory. 
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/usr/lib/X11/rgb.txt Color database. 
/tmp/.X11-unix/X* Unix domain socket. 
/usr/adm/X*msgs Error log file. 

SEE ALSO 


X(1), xinit(1), xterm(1), xwm(1), xhost(1), xset(1), xsetroot(1), ttys(5), init(8), X Window System Proto- 
col, Definition of the Porting Layer for the X v11 Sample Server, Strategies for Porting the X v1l Sample 
Server. 


BUGS 
The option syntax is inconsistent with itself and xset(1). 


The acceleration option should take a numerator and a denominator like the protocol. 


If X dies before its clients, new clients won’t be able to connect until all existing connections have their 
TCP TIME_WAIT timers expire. 


The color database is missing a large number of colors. However, there doesn’t seem to be a better one 
available that can generate RGB values. 
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NAME 


bitmap — bitmap editor for X 


SYNTAX 


bitmap [ —options ] filename [ WIDTHxHEIGHT ] 


DESCRIPTION 


Bitmap lets you interactively create bitmaps, or edit previously created bitmaps. A bitmap is simply a rec- 
tangular array of 0 and 1 bits. The X Window System uses bitmaps in defining clipping regions, cursor 
shapes, icon shapes, and tile and stipple patterns. 


When you run bitmap, you are given a magnified version of the bitmap, in which each bit is shown as a 
large square, as if it were a piece of graph paper. The pointer can be used to set, clear, or invert individual 
squares, and to invoke commands to set, clear or invert larger rectangular areas of the bitmap. Other com- 
mands may be used to move or copy rectangular areas from one part of the bitmap to another, and to define 
a hot spot (a special single point on the bitmap, which is useful when the bitmap is used as an X cursor). 


The output of the bitmap program is a small C code fragment. By #include’ing such a program fragment 
in your program, you can easily declare the size and contents of cursors, icons, and other bitmaps that your 
program creates to deal with the X Window System. 


OPTIONS 

—help Causes a brief description of the allowable options and parameters to be 
printed. 

—display display Specifies the server to be used. See X(1) for details. 

—geometry geometry Specifies the placement and size of the bitmap window on the screen. See 
X(1) for details. 

—nodashed Indicates that the grid lines in the work area should not be drawn using dashed 
lines. Although dashed lines are prettier than solid lines, on some servers they 
are significantly slower. 

—bw number Specifies the border width in pixels of the main window. 

—fn font Specifies the font to be used in the buttons. 

~fg color Specifies the color to be used for the foreground. 

~bg color Specifies the color to be used for the background. 

—hl color Specifies the color to be used for highlighting. 

~bd color Specifies the color to be used for the window border. 

—ms color - Specifies the color to be used for the pointer (mouse). 


When bitmap starts, it first tries to read the specified file (see FILE FORMAT). If the file already exists, it 
creates a window containing a grid of the appropriate dimensions. 


If the file does not exist, bitmap creates a window for a bitmap of the size specified by WIDTHxHEIGHT 
(e.g., 7x9, 13x21). The bitmap starts out empty. If WIDTHxHEIGHT is not specified either on the com- 
mand line or in the Dimensions X Default, 16x16 is assumed. 


The window that bitmap creates has four parts. The largest section is the checkerboard grid, which is a 
magnified version of the bitmap you are editing. At the upper-right is a set of commands that you can 
invoke with any pointer button. Below the commands is an actual size picture of the bitmap you are edit- 
ing; below that is an inverted version of the same bitmap. Each time you alter the image in the grid, the 
change is reflected in the actual-size versions of the bitmap. 
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If you use a window manager to make the bitmap window larger or smaller, the grid squares automatically 
get larger or smaller as well. 


COMMANDS 
(Note for users of color displays: In all of the following, white means the background color, and black 


means the foreground color.) 


When the cursor is in the checkerboard region, each pointer button has a different effect upon the single 
square that the cursor is over: 


Button 1 (The left mouse button.) Sets the indicated square. 

Button 2 (The middle mouse button.) Inverts the indicated square. 

Button 3 (The right mouse button.) Clears the indicated square. 

The various commands are invoked by pressing any pointer button in the corresponding command box: 


Clear All Clears all squares in the bitmap. Caution: This command is irreversible, so invoke it with 
care. 


Set All Sets all squares in the bitmap. Caution: This command is irreversible, so invoke it with 
care. 


Invert All _Inverts all squares in the bitmap. 


Clear Area Clears a rectangular area of the bitmap. After you click over this command, the cursor turns 
into an upper-left corner. Press any pointer button over the upper-left corner of the area you 
want to clear, hold the button down while moving the pointer to the lower-right corner of the 
area you want to clear, and then release the button. 


While you are holding down the button, the selected area will be covered with X’s, and the 
cursor will change to a lower-right comer. If you now wish to abort the command without 
clearing an area, either press another pointer button, move the cursor outside the grid, or 
move the cursor to the left of or above the upper-left corner. 


Set Area Sets a rectangular area of the bitmap. It works the same way as the Clear Area command. 


Invert Area Inverts a rectangular area of the bitmap. It works the same way as the Clear Area com- 
mand. 


Copy Area Copies a rectangular area from one part of the grid to another. First, you select the rectangle 
to be copied, in the manner described above under Clear Area above. Then, the cursor 
changes to an upper-left corner. When you press a pointer button, a destination rectangle 
overlays the grid; moving the pointer while holding down the button moves this destination 
rectangle. The copy occurs when you release the button. To cancel the copy, move the 
pointer outside the grid and then release the button. 
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Move Area Works identically to Copy Area, except that it clears the source rectangle after copying to 


the destination. 

Line Draws a line between two points. 

Overlay Area 
Works identically to Copy Area, except that it does a binary OR of the source rectangle 
with the destination. 

Circle Draws a circle specifying the center and a radius. 


Filled Circle Draw a filled circle given the center and radius of the circle. 


Set HotSpot Designates a point on the bitmap as the hot spot. If a program is using your bitmap as a cur- 
sor, the hot spot indicates which point on the bitmap is the actual location of the cursor. For 
instance, if your cursor is an arrow, the hot spot should be the tip of the arrow; if your cur- 
sor is a cross, the hot spot should be where the perpendicular lines intersect. 


Clear HotSpot 
Removes any hot spot that was defined on this bitmap. 


Write Output 
Writes the current bitmap value to the file specified in the original command line. If the file 
already exists, the original file is first renamed to filename” (in the manner of emacs(1) and 
other text editors). 


If either the renaming or the writing cause an error (e.g., “‘Permission denied’’), a dialog 
window appears, asking if you want to write the file /tmp/filename instead. If you say yes, 
all future Write Output commands write to /tmp/filename as well. See below for the format 
of the output file. 


Quit Exits the bitmap program. If you have edited the bitmap and have not invoked Write Out- 
put, or you have edited it since the last time you invoked Write Output, a dialog window 
appears, asking if you want to save changes before quitting. ‘“Yes’’ does a ‘‘Write Output’’ 
before exiting; ‘‘No’’ just exits, losing the edits; ‘‘Cancel’’ means you decided not to quit 
after all. 


FILE FORMAT 
Bitmap reads and writes files in the following format, which is suitable for #include’ing in a C program: 
#define name_width 9 
#define name_height 13 
#define name_x_hot 4 
#define name_y_hot 6 
static char name_bits[] = { 
0x10, 0x00, 0x38, 0x00, 0x7c, 0x00, 0x10, 0x00, 0x10, 0x00, 0x10, 0x00, 
Oxff, 0x01, 0x10, 0x00, 0x10, 0x00, 0x10, 0x00, 0x7c, 0x00, 0x38, 0x00, 
0x10, 0x00}; 


The variables ending with x hot and _y_hot are optional; they are present only if a hot spot has been | 
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defined for this bitmap. The other variables must be present. 


The name portion of the five variables are derived from the name of the file that you specified on the origi- 
nal command line by 

(1) deleting the directory path (all characters up to and including the last ‘‘/,’’ if one is present). 

(2) deleting the extension (the first ‘‘.”’, if one is present, and all characters beyond it). 


For example, invoking bitmap with filename /usr/include/bitmaps/cross.bitmap produces a file with vari- 
able names cross_width, cross_height, and cross_bits (and cross_x_hot and cross_y_hot if a hot spot is 
defined). 


It’s easy to define a bitmap or cursor in an X program by simply #include’ ing a bitmap file and referring to 
its variables. For instance, to use a cursor defined in the files this.cursor and this_mask.cursor, one simply 
writes 


#include "this.cursor" 

#include "this_mask.cursor" 

Pixmap source = XCreateBitmapFromData (display, drawable, this_bits, this_width, this_height); 

Pixmap mask = XCreateBitmapFrom Data (display, drawable, this_mask_bits, 
this_mask_width, this_mask_height); 

Cursor cursor = XCreatePixmapCursor (display, source, mask, foreground, background, 
this_x_hot, this_y_hot); 


where foreground and background are XColor(3X) values. 
An X program can also read a bitmap file at runtime by using the function XReadBitmapFile(3X). 


The bits are in XYBitmap(3X) format, with bitmap_unit = bitmap_pad = 8, and byte order = 
bitmap_bit_order = LSBFirst (least significant bit and byte are leftmost). 


For backward compatibility with X10, bitmap can also read in a file where the bits array is declared as 
Static short foo_bits{] and consists of an array of 16-bit hex constants. This is interpreted as a 
XYBitmap(3X) with bitmap_unit = bitmap_pad = 16, byte_order bitmap_bit_order = LSBFirst. If you 
modify the bitmap after reading in such a file, bitmap will always write. the file back out in standard X11 


format. 
X DEFAULTS 

The bitmap program uses the routine XGetDefault(3X) to read defaults, so its resource names are all capi- 

talized. 

Background The window’s background color. Bits which are 0 in the bitmap are displayed 
in this color. This option is useful only on color displays. The default value is 
white. 

BorderColor The border color. This option is useful only on color displays. The default 
value is black. 

BorderWidth The border width. The default value is 2. 

BodyFont The text font. The default value is ‘‘variable.”’ 

Foreground The foreground color. Bits which are 1 in the bitmap are displayed in this 


color. This option is useful only on color displays. The default value is black. 
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Highlight The highlight color. bitmap uses this color to show the hot spot and to indi- 
cate rectangular areas that will be affected by the Move Area, Copy Area, 
Set Area, and Invert Area commands. If a highlight color is not given, then 
bitmap will highlight by inverting (clearing). This option is useful only on 


color displays. 
Mouse The pointer (mouse) cursor’s color. This option is useful only on color 
displays. The default value is black. 
Geometry The size and location of the bitmap window. 
Dimensions The WIDTHxHEIGHT to use when creating a new bitmap. 
ENVIRONMENT 
DISPLAY The default host and display number. 
XENVIRONMENT The name of the default file to use. 
SEE ALSO 


X(1), emacs(1), XReadBitmapFile(3), XGetDefault(3X), Xlib - C Language X Interface, particularly the 
section ‘‘Manipulating Bitmaps.”’ 


DIAGNOSTICS 
The following messages may be printed to the standard error output. Any of these conditions aborts bit- 
map before it can create its window. 
**bitmap: could not connect to X server on host:display’’ 
Either the display given on the command line or the DISPLAY énvironment variable has an invalid host 
name or display number, or the host is down, or the host is unreachable, or the host is not running an X 
server, or the host is refusing connections. 
‘*bitmap: no file name specified’’ 
You invoked bitmap with no command line arguments. You must give a file name as the first argument. 
‘*bitmap: could not open file filename for reading -- message’ 


The specified file exists but cannot be read, for the reason given in <message> (e.g., permission denied). 


**bitmap: invalid dimensions string’’ 
**bitmap: dimensions must be positive’ 


The second command line argument was not a valid dimension specification. 

““bitmap: Bitmap file invalid" 
The input file is not in the correct format; the program gave up when trying to read the specified data. 
The following messages may be printed after bitmap creates its window: 


““bitmap: Unrecognized variable name in file filename’’ 
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Bitmap encountered a variable ending in something other than x hot, y_ hot, width, or _height while 
parsing the input file. It will ignore this variable and continue parsing the file. 


“‘bitmap: XError: message’’ 
‘*bitmap: XIOError’’ 


A protocol error occurred. Something is wrong with either the X server or the X library which the program 
was compiled with. Possibly they are incompatible. If the server is not on the local host, maybe the con- 
nection broke. 


BUGS 
The old command line arguments aren’t consistent with other X programs. 


The foreground, background, and highlight colors are ignored unless new values for all three are specified. 


If you move the pointer too fast while holding a pointer button down, some squares may be missed. This is 
caused by limitations in how frequently the X server can sample the pointer location. 


There is no way to write to a file other than the one specified on the command line. 
There is no way to change the size of the bitmap once the program has started. 
There is no undo command. 


If you read in an X10-format bitmap, the Quit and Write Output commands won’t write out a new X11- 
format file unless you’ve changed at least one square on the bitmap. You can work around this by simply 
Clearing a square and then clearing it back again. 


This program would make a wonderful X Toolkit application. 
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NAME 
ico ~ animate an icosahedron or other polyhedron 


SYNOPSIS 
ico [-display display] [-geometry geometry] [-r] [-d pattern] [-i] [-dbl] [-faces] [-noedges] [-sleep n] [-obj 
object] [-objhelp] [-colors color-list] 

DESCRIPTION 


Ico displays a wire-frame rotating polyhedron, with hidden lines removed, or a solid-fill polyhedron with 
hidden faces removed. There are a number of different polyhedra available. Adding a new polyhedron to 


the program is quite simple. 
OPTIONS 
-r Displays on the root window instead of creating a new window. 
-d pattern Specifies a bit pattern for drawing dashed lines for wire frames. 
“i : Uses inverted colors for wire frames. 
-dbl Uses double buffering on the display. This works for either wire frame or solid 


fill drawings. For solid fill drawings, using this switch results in substantially 
smoother movement. Note that this requires twice as many bit planes as without 
double buffering. Since some colors are typically allocated by other programs, 
most 8-bit-plane displays will probably be limited to eight colors when using dou- 


ble buffering. 
-faces Draws filled faces instead of wire frames. 
-noedges Doesn’t draw wire frames. Typically used only when -faces is used. 
-sleep n Sleeps n seconds between each move of the object. 
-obj object Specifies what object to draw. If no object is specified, an icosahedron is drawn. 
-objhelp Prints out a list of the available objects, along with information about each object. 


-colors color color... Specifies what colors should be used to draw the filled faces of the object. If 
fewer colors than faces are given, the colors are reused. 


ADDING POLYHEDRA 
If you have the source to ico, it is very easy to add more polyhedra. Each polyhedron is defined in an 
include file by the name of objXXX.h, where XXX is something related to the name of the polyhedron. The 
format of the include file is defined in the file polyinfo.h. Look at the file objcube.h to see what the exact 
format of an objXXX.h file should be, then create your objXXX.h file in that format. - 


After making the new objXXX.h file (or copying in a new one from elsewhere), simply do a ‘‘make 
depend’’. This will recreate the file allobjs.h, which lists all of the objXXX.h files. Doing a ‘‘make’’ after 
this will rebuild ico with the new object information. 


SEE ALSO 
X(1) 


BUGS 
A separate color cell is allocated for each name in the -colors list, even when the same name may be 
specified twice. | 
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NAME 
muncher — draws interesting patterns in an X window 
SYNOPSIS 
muncher [-option ...] 
OPTIONS 
-r Displays in the root window. 
—s seed Seeds the random number seed. 
-v Runs in verbose mode. 
~q Runs in quite mode. | 
—geometry geometry Defines the initial window geometry; see X(1). 
—display display Specifies the display to use; see X(1). 
DESCRIPTION 
Muncher draws some interesting patterns in a window. 
SEE ALSO 
X(1) 
BUGS 


There are no known bugs. There are lots of features lacking. 
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NAME 
plaid — paints some plaid-like patterns in an X window 
SYNOPSIS 
plaid [-option ...] 
OPTIONS 
—b Enables backing store for the window. 
—geometry geometry Defines the initial window geometry; see X(1). 
—display display Specifies the display to use; see X(1). 
DESCRIPTION 
Plaid displays a continually changing plaid-like pattern in a window. 
SEE ALSO 
X(1) 
BUGS 


There are no known bugs. There are lots of features lacking. 
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NAME 
puzzle — 15-puzzle game for X 
SYNOPSIS 
puzzle [-option ...] 
OPTIONS] 
—display display Specifies the display to use; see X(1). 
—geometry geometry Specifies the size and position of the puzzle window; see X(1). 
—size WIDTHxHEIGHT Specifies the size of the puzzle in squares. 
—speed num Specifies the speed in tiles per second for moving tiles around. 
—picture filename Specifies an image file containing the picture to use on the tiles. Try 
mandrill.cm. This only works on 8-bit pseudo-color screens. . 
—colormap Indicates that the program should create its own colormap for the picture 
option. 
DESCRIPTION 


Puzzle with no arguments plays a 4x4 15-puzzle. The control bar has two boxes in it. Clicking in the left 
box scrambles the puzzle. Clicking in the right box solves the puzzle. Clicking the middle button any- 
where else in the control bar causes puzzle to exit. Clicking in the tiled region moves the empty spot to 
that location if the region you click in is in the same row or column as the empty slot. 


SEE ALSO 
X(1) 


BUGS 
The picture option should work on a wider variety of screens. 
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NAME 


twm - a window manager for X11 (Tom’s Window Manager) 


SYNTAX 


twm [-display display] 


DESCRIPTION 


The twm program is a window manager client application of the window server. 


The twm program was written to try and incorporate some of the desirable features of both the wm and 
uwm window managers. Twm puts a title bar on and re-parents each window. The title bar contains the 
window’s name and three "buttons". When a pointer button press event is detected in any of these title bar 
"buttons" a certain action is performed. The left-most title bar button that looks like a window pane causes 
the window to be iconified. The right-most title bar button with the right-angles is the re-size button. The 
resize function is identical to the window resize function of the wm window manager. The other title bar 
button is supposed to represent a keyboard, a button click here causes the input focus to be directed to this 
window until the f.unfocus function is executed or another window is selected to get input focus. The title 
bar has the additional feature of becoming highlighted if the window has the input focus. 


When twm is invoked, it attempts to read a twm startup file. The name of the twm startup file is: 


$HOME/.twmrc 


The twm startup file can be thought of as having three logical sections: the variables section, the buttons 
section, and the menus section. The variables section must come first, followed by either the buttons sec- 
tion or the menus section. 


All variables and keywords may be entered in any combination of upper and lower case letters. Title func- 
tions and Root functions must be entered in lower case. A pound sign (#) character in the startup file indi- 
cates a comment which is terminated by the newline character. A string in the startup file is a series of 
characters enclosed by double quotes. 


VARIABLES SECTION 


Variables must be entered first, at the top of the startup file. Variables are initialized once when twm 


begins execution, they will not be effected when a f.twmrc function is executed. 


Several variables take filenames as arguments. Filenames are processed as follows. Twm checks to see if 
the first character in the filename is a tilde (~), if it is, fvm prepends the user’s HOME environment vari- 
able to the filename. In the case of variables requiring bitmap files, if the above expansion does not pro- 
duce a path to a valid bitmap file, the following steps are taken. If the IconDirectory variable has been set, 
and the filename does not start with a slash (/), the IconDirectory variable is prepended to the filename. If 
that path does not produce a valid bitmap file, the string "/usr/include/X11/bitmaps/" is prepended to the 
original filename. 


The following describes the twm variables: 


AutoRaise { list } This variable is a list of window names that will automatically raise to the top of 
the stacking order whenever the pointer enters the window. The window names in 
the list are the first characters in the window name to check for. For example: 


AutoRaise 


{ 


" wt 


xterm 
"xclock" 


} 


The above list contains two names which will match window names beginning 
with the string "xterm" or "xclock". The following window names will match and 


at te tt 


be in auto-raise mode: "xterm", "xterm_iguana", "xclock”. 
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BorderColor string 


BorderWidth pixels 


Color { colors } 


DontMoveOff 
ForcelIcons 


Icons { list } 


IconBackground string 


IconBorderColor string 


IconDirectory string 


IconFont string 
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This variable sets the color of the border to placed around all non-iconified win- 
dows. It can only be specified inside of a Color or Monochrome list. The default 
is "black". 

This variable specifies the width in pixels of of the border surrounding all win- 
dows. The default is 2. 


This variable is a list of color assignments to be made if the default display has a 
depth greater than one, or in other words, has the ability to display more than 
black and white. For example: 


Color 


BorderColor "red" 
TitleForeground "yellow" 
TitleBackground "blue" 

} 


The various color variables may be found in this section of the manual page. 
There is also a Monochrome list of colors that may be specified. This enables 
you to use the same initialization file on a color or monochrome display. 


If this variable is set, windows will not be allowed to be moved off the display. 


This variable is only meaningful if a Icons list is defined. It forces the icon bit- 
maps listed in the Icons list to be used as window icons even if client programs 
supply their own icons. The default is to not force icons. 


This variable is a list of window names and bitmap filenames to be used as icons. 
For example: 


Icons 
"xterm" "xterm.icon" 
"xfd" "“xfd_icon” 


} 


The names "xterm" and "xfd" are added to a list that is searched when the client 
window is reparented by twm. The window names specified are just the first por- 
tion of the name to match. In the above example, "xterm" would match 
"xtermfred" and also "xterm blob". The client window names are checked against 
those specified in this list in addition to the class name of the client if it is 
specified. By using the class name, all xterm windows can be given the same icon 
by the method used above even though the names of the windows may be dif- 
ferent. 


This variable sets the background color of icons. It can only be specified inside of 
a Color or Monochrome list. The default is "white". 


This variable sets the color of the border around icons. It can only be specified 
inside of a Color or Monochrome list. The default is "black". 


This variable names the directory in which to search for icon bitmap files. This 
variable is described under the VARIABLES SECTION heading. The default is 
to have no icon directory. 


This variable names the font to be displayed within icons. The default is "8x13". 


IconForeground string This variable sets the foreground color of icons. It can only be specified inside of 
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a Color or Monochrome list. The default is "black". 


MenuBackground string 
This variable sets the background color of menus. It can only be specified inside 
of a Color or Monochrome list. The default is "white". 


MenuFont string This variable names the font to be displayed within menus. The default is "8x13". 


MenuForeground string 
This variable sets the foreground color of menus. It can only be specified inside 
of a Color or Monochrome list. The default is "black". 


MenuShadowColor string 
This variable sets the color of the shadow behind pull-down menus. It can only be 
specified inside of a Color or Monochrome list. The default is "black". 


MenuTitleBackground string 
This variable sets the background color for f.title entries in menus. It can only be 
specified inside of a Color or Monochrome list. The default is "white". 


MenuTitleForeground string 
This variable sets the foreground color for f.title entries in menus. It can only be 
specified inside of a Color or Monochrome list. The default is “black”. 


Monochrome { colors } 
This variable is a list of color assignments to be made if the default display has a 
depth equal to one, or in other words can only display black and white pixels. For 
example: 


Monochrome 


{ | 
BorderColor "black" 
TitleForeground "black" 
TitleBackground "white" 

} 


The various color variables may be found in this section of the manual page. 
There is also a Color list of colors that may be specified. This enables you to use 
the same initialization file on a color or monochrome display. 


NoTitle { list } This variable is a list of window names that will NOT have a title bar created for 
them. If the client does not get ButtonPress events, twm will get them and all Title 
functions currently in effect will work when pointer buttons are pressed in the 
client window. The list of windows and how they match window names is exactly 
like the AutoRaise variable described above. 


NoRaiseOnDeiconify If this variable is specified, windows will not be raised to the top of the stacking 
order when de-iconified. 


NoRaiseOnMove If this variable is specified, windows will not be raised to the top of the stacking 
order following a move. 

NoRaiseOnResize If this variable is specified, windows will not be raised to the top of the stacking 
order following a resize. 

NoTitleFocus _ If this variable is specified, input focus will not be directed to windows when the 


pointer is in the title bar. The default is to focus input to a client when the pointer 
is in the title bar. 


ResizeFont string This variable names the font to be displayed in the dimensions window during 
window resize operations. The default is "fg-22". 
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TitleFont string This variable names the font to be displayed within the window title bar. Note 
that the title bar is only 17 pixels in height, so the largest practical font would be 
something like "9x15". The default is "8x13". 


Reverse Video This variable causes twm to display white characters on a black background, 
rather than black characters on white. This variable doesn’t really do much now 
that you can specify individual colors. 


TitleBackground string 
This variable sets the background color for the title bars. It can only be specified 
inside of a Color or Monochrome list. The default is "white". 


TitleForeground string This variable sets the foreground color for the title bars. It can only be specified 
inside of a Color or Monochrome list. The default is "black". 


Unknownlcon string This variable specifies the file name of a bitmap format file to be used as the 
default icon. This bitmap will be used for the icon of all clients which do not pro- 
vide an icon bitmap and are not listed int the Icons list. The default is to use no 
bitmap. 


WarpCursor This variable causes the pointer cursor to be warped to a window which is being 
deiconified. The default is to not warp the cursor. 


Zoom This variable causes a series of outlines to be drawn when a window is iconified 
or deiconified. The default is to not draw the outlines. 


BUTTONS SECTION 
This section deals with assignment of window manager functions to mouse buttons. The discussion of 
Root functions and Title functions is included here for historical reasons and to maintain compatibility with 
versions of twm prior to Revision 2.15. The section titled New Button Specifications describes the new 
syntax for defining pointer button sequences. The older syntaxes described in the following paragraphs are 
still supported. 


The buttons section of the startup file contains definitions of functions to perform when pointer buttons are 
pressed. There are two classes of functions that can be tied to a pointer button: Title functions, which will 
be executed if a pointer button is pressed while the pointer is in the title bar of a window; and Root func- 
tions, which will be executed while the pointer is in the root window or if the client program is not process- 
ing pointer button events. 


Title functions are assigned as follows: 


TitleButtonn t function TitleButton is a startup file keyword. The n following TitleButton can be a 
number between 1 and 5 to indicate which pointer button the function is to be tied . 
to. t.function may be any one of the following title functions. 


Title Functions 
The following title functions are still included for compatibility reasons. Since Revision 2.15, Itwm can 
execute any root function tied to a title bar pointer button press. 


t.lower This function lowers the window to the bottom of the stacking order. 


t.move This function causes a grid to appear over the window which can be moved to 
where you want the window to be moved. Double clicking the pointer button tied 
to this function causes a constrained move function to be executed. The pointer 
will be warped to the center of the grid. Moving the pointer to one of the grid 
lines will cause the window to begin moving in either an up-down motion or a 
left-right motion depending on which grid line the pointer was moved across. 


t.nop | This function does nothing. 
t.raise This function raises the window to the top of the stacking order. 
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The defaults for title functions are as follows: 
TitleButton1 t.raise 
TitleButton2 t.move 
TitleButton3 t.lower 
TitleButton4 t.nop 
TitleButtonS t.nop 


Root functions are assigned either to a pointer button or a menu entry. The f.title function is the only one 
that doesn’t really make sense to use as just a button function. It was designed to be used in a pull-down 
menu. Root functions are assigned to pointer buttons as follows: 


Buttonn function Button is a startup file keyword. The n following Button can be a number 
between 1 and 5 to indicate which pointer button the function is to be tied to. func- 
tion may be any one of the following root functions. 


New Button Specifications 
Versions of twm newer or equal to Revision 2.15 support the new pointer button specification syntax which 
allows functions and menus to be tied to buttons with a variety of modifier keys being pressed in conjunc- 
tion with pointer buttons.. The syntax of the new button specification is: 


Buttonn = keys : context: function 


The n following Button can be a number between 1 and 5 to indicate which pointer button the function is 
to be tied to. The keys field is used to specify which modifier keys must be pressed in conjunction with the 
pointer button. The keys field may contain any combination of the letters s, c, and m, which stand for 
Shift, Control, and Meta, respectively. The context field specifies the context in which to look for the but- 
ton press. Valid contexts are: icon, root, title, and window. The function field specifies what window 
manager function to perform. The old Button and TitleButton specifications are simple cases of the new 
syntax. Now for some examples: 


Button2= __: title : f.move #1 
Buttonl= :root : f.menu "menu 1" #2 
Buttonl=m :icon :f.menu “icon menu 1" #3 
Button3 = msc: window: f.menu "menu3 1" _ #4 


Line 1 specifies that when pointer button 2 is pressed in the title bar with no modifier keys pressed, the 
f.move function is to be executed. This is exactly the same as TitleButton2 t.move. Line 2 specifies that 
when pointer button 1 is pressed in the root window with no modifier keys pressed, the menu "menu 1" is 
popped up. This is exactly the same as Button2 f.menu "menu 1". Line 3 specifies that when pointer but- 
ton 1 is pressed in an icon window with the meta key pressed, the menu "icon menu 1" is popped up. Line 
4 specifies that when pointer button 3 is pressed in a client window with the shift, control, and meta keys 
pressed, the menu "menu 3” is popped up. 


Root Functions 


! string This function causes string to be sent to /bin/sh for execution. 

* string This function causes string followed by a new line character to be placed in the 
window server’s cut buffer. 

f.circledown This function causes the top window that is obscuring another window to drop to 
the bottom of the stack of windows. 

f.circleup This function raises the lowest window that is obscured by other windows. 

f.cutfile This function takes the contents of the window server’s cut buffer and uses it as a 


filename to read into the server’s cut buffer. 


f.destroy This function allows you to destroy a window client. The cursor is changed to a 
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f.file string 


f.focus 


f.iconify 


f.lower 


f.menu string 


f.move 


f.nop 
f.quit 


f.raise 


f.refresh 


f.resize 


f.source string 


f.title 


f.twmrc 


f.unfocus 


f.version 


f.winrefresh 


1 September 1988 


X Window System Reference Manual TWM (1) 


skull and crossbones and the next window to receive a button press will be des- 
troyed. 


This function assumes string is a file name. This file is read into the window 
server’s cut buffer. 


This function implements the same function as the keyboard focus button in the 
title bar. The cursor is changed to a dot and the next window to receive a button 
press will gain the input focus. 


This function implements the same function as the iconify button in the title bar. 
The cursor is changed to a dot and the next window to receive a button press will 
be iconified or de-iconified depending on the current state of the window. 


This function implements the window lower function of t.lower, but lets you get 
to it from a menu selection. The cursor is changed to a dot and the next window 
that receives a button press will be the window that is lowered. 


This function assigns the pull-down menu named string to a pointer button. If this 
function is used as an entry in a pull-down menu a pull-right menu will be 
assigned to the menu entry. 


This function implements the window move function of t.move, but lets you get to 
it from a menu selection. The cursor is changed to a double arrow and the next 
window that receives a button press will be the window that is moved. 


This function does nothing. 
This function causes twm to exit. 


This function implements the window raise function of t.raise, but lets you get to 
it from a menu selection. The cursor is changed to a dot and the next window that 
receives a button press will be the window that is raised. 


This function causes all windows to be refreshed. 


This function implements the window resize function of the resize button in the 
title bar. The cursor is changed to a double arrow and the next window that 
receives a button press will be the window that is resized. 


This function assumes string is a file name. The file is read and parsed as a twm 
startup file. This function is intended to be used only to re-build pull-down 
menus. None of the twm variables are changed. 


This function is to be used as an entry in a pull-down menu. It centers the menu 
entry string in a menu entry and outlines it with a border. This function may be 
used more than once in a pull-down menu. 


This function causes the $SHOME/.twmrc file to be re-read. This function is 
exactly like the f.source function without having to specify the filename. 


This function assigns input focus to the root window. 


This function causes the twm version window to be displayed. This window will 
be displayed until a pointer button is pressed or the pointer is moved from one 
window to another. 


This function is similar to the f.refresh function, but allows you to refresh a single 
window. The cursor is changed to a dot and the next window that receives a but- 
ton press will be the window that is refreshed. 
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MENUS SECTION 
The menus section is where pull-down menus are defined. Entries in menus consist of Root functions as 
described in the Buttons Section. The syntax to define a menu is: 


Menu "menu name" 
{ 

string function 
String function 


string function 


The menu name should be an identical string to one being used with an f.menu Root function. Note that the 
menu name is case sensative. The string portion of each menu entry will be the text which will appear in 
the menu. The function portion of the menu entry is one of the Root functions described in the previous 
section. 


WINDOW STARTUP 
When a client is started, twm allows you to position and change the size of the window if the client has not 
specified an initial geometry. If the client has not specified both User Specified Size hints and User 
Specified Position hints, twm will put up a rubberband box indicating the initial window size. If pointer 
button one is pressed, the client window is created with the window position equal to the current pointer 
position. If pointer button two is pressed, twm allows the window to be resized. The resizing operation 
takes place until button two is released. While the initial positioning of the window is taking place, twm 
will place a window in the upper-left corner of the display showing the window’s name. If resizing is tak- . 

ing place, twm will also place a window in the upper-left corner, indicating the current window size. 


EXAMPLES 
The following is an example twm startup file: 


FEA A 2 2 i RI I IO EF III II IOI II I I RI ICI a CR a te a a ka ea es 


# 

# .twmrc 

# . 
EF Ai He oe ae obs 2 2h aie he fe fe ake fe ae ale he Ye At fe oe ae 9c He 2h 24 fe a ofc fe fe ake fe 2 ake fe ake ae of 2 ae afc he afc ofe fe ake afc abe ake ofc fe ake fe oh aie fe fe 2k afe aie fe of afc ate ake afe ake fe fe 
WarpCursor 

BorderWidth 2 

TitleFont "8x13" 

MenuFont "8x13" 

IconFont "8x13" 

Color 

{ 


BorderColor "red" 
TitleForeground "white" 
TitleBackground "blue" 
MenuForeground "yellow" 
MenuBackground "darkgreen" 
MenuTitleForeground "red" 
MenuTitleBackground "blue" 
IconForeground "darkgreen" 
IconBackground "cadetblue" 
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IconBorderColor "green" 


J 


#Button = KEYS : CONTEXT : FUNCTION 


Fate aS ees ee 
Buttonl= :root :f.menu "buttonl" 

Button2= :root : f.menu "button2" 

Button3= root: f.menu “button3" 

Button] = m_ : window : f.menu "button1" 

Button2= m_ : window : f.menu “button2" 

Button3 = m_ : window : f.menu "button3" 

Buttonl = m : title : f.menu "button1" 

Button2= m : title : f.menu “button2" 

Button3 = m : title : f.menu “button3" 

Buttonl= _: title : f.raise 

Button2= =: title : f.move 

Button3= =: title : tlower 

ForcelIcons 

IconDirectory ““/icons" 

Icons 

{ 

"xterm" “xterm.icon" # obtained from IconDirectory : 
"xfd" "xfd_icon" # obtained from /usr/include/X11/bitmaps 
} 

Unknownlcon  "default.icon" 

AutoRaise 

{ 

"xterm" # all of my xterm windows will auto-raise 
} 

NoTitle 

{ 

"xclock" # don’t need a title bar on this ... 
"xckmail" # or this 

}. 

menu "button1" 

{ 

"Sun Systems" _ f.title 


"i gu an qa" 
t Ww orm" 
"shiva" 
"tegus" 
"Vax Systems” 
"shade" 
“bilbo" 
"frodo" 
“esunix" 
"lynx8" 

} 
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"xterm -T iguana =80x24+100+100 -e rlogin iguana &" 


!"xterm -T worm =80x24+100+100 &” 

!"xterm -T shiva =80x24+200+200 -e rlogin shiva &" 
"xterm -T tegus =80x24+200+200 -e rlogin tegus &" 
f.title 

"xterm -T shade =80x24+200+200 -e rlogin shade &" 
{xterm -T bilbo =80x24+250+250 -e rlogin bilbo &" 
"xterm -T frodo =80x24+300+300 -e rlogin frodo &" 
!"xterm -T esunix =80x24+350+350 -e rlogin esunix &" 
"xterm -T lynx8 =80x24+390+390 -e rlogin lynx8 &" 
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BUGS 


menu "button2" 


{ 

"Window Ops” 
"Refresh" 

"Focus on Root" 
"Source .twmrc" 
"Source something” 
"twm Version" 
"(De)Iconify" 
"Move Window" 
"Resize Window" 
"Raise Window" 
"Lower Window" 


"Focus on Window" 


"Destroy Window" 
} 


menu "button3" 


{ 

"Cut Buffer" 
"Procedure Header" 
"File Header" 

"pull right” 

} 


menu "blob" 
{ 

“pull right" 
"another" 


}. 


menu "final" 
{ 

" entry 1" 

AL] entry 2" 

w entry 3" 

w entry 4" 

} 
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f.title 

f.refresh 

f.unfocus 

f.twmrc 

f.source "something" 
- f.version 


f.iconify 


f.move 
f.resize 
f.raise 
f.lower 
f.focus 
f.destroy 


f.title 

f.file "/usr/ias_soft/tlastrange/src/proc.twm" 
f.file "/usr/ias_soft/tlastrange/src/file.twm" 
f.menu "blob" 


f.menu “final” 
“"some text” 


fnop 
f.nop 
f.nop 
f.nop. 


TWM (1) 


Pull-right menus may still have some problems. They may sometimes stay around when all pointer buttons 
have been released. 


Double clicking very fast to get the constrained move function will sometimes cause the window to move, 
even though the pointer is not moved. 


The window auto-raise feature does not work consistently when the mouse is moved very fast over auto- 
raise windows. 


There is a latency problem. You can move the mouse and begin typing and the first few characters will 
appear in the window the cursor was moved out of. 
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FILES 
$HOME/.twmrc 


SEE ALSO 
X(1), Xserver(1) 


COPYRIGHT 
COPYRIGHT 1988 
Evans & Sutherland Computer Corporation © 
Salt Lake City, Utah 
All Rights Reserved. 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND 
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY EVANS & SUTHERLAND. EVANS & 
SUTHERLAND MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THIS 
SOFTWARE FOR ANY PURPOSE. IT IS SUPPLIED "AS IS" WITHOUT EXPRESS OR IMPLIED 
WARRANTY. 


IF THE SOFTWARE IS MODIFIED IN A MANNER CREATING DERIVATIVE COPYRIGHT 
RIGHTS, APPROPRIATE LEGENDS MAY BE PLACED ON THE DERIVATIVE WORK IN ADDI- 
TION TO THAT SET FORTH ABOVE. 


Permission to use, copy, modify, and distribute this software and its documentation for any purpose and 
without fee is hereby granted, provided that the above copyright notice appear in all copies and that both 
the copyright notice and this permission notice appear in supporting documentation, and that the name of 
Evans & Sutherland not be used in advertising or publicity pertaining to distribution of the software 
without specific, written prior permission. 


AUTHOR 
Thomas E. LaStrange, Evans & Sutherland, Interactive Systems Division, Salt Lake City, Utah. 


{ihnp4 ,decvax }!decwrl!esunix!tlastran 
{cbosgd,ulysses}!utah-cs!esunix!tlastran 
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uwm — a window manager for X 


SYNTAX 


uwm [-display display] [-f filename] 


DESCRIPTION 


The uwm program is a window manager client application of the window server. 


When uwm is invoked, it searches a predefined search path to locate any uwm startup files. If no startup 
files exist, uwm initializes its built-in default file. 


If startup files exist in any of the following locations, it adds the variables to the default variables. In the 
case of contention, the variables in the last file found override previous specifications. Files in the uwm 


search path are: 


/usr/lib/X11/uwmlsystem.uwmrc 


S$HOME/.uwmrc 


To use only the settings defined in a single startup file, include the following variables at the top of that 
specific startup file: resetbindings, resetmenus, and resetvariables. 


OPTIONS 
—display display 


—f filename 
STARTUP FILE VARIABLES 


Specifies the server to be used. See X(1) for details. 
Names an alternate file as a uwm startup file. 


Variables are typically entered first, at the top of the startup file. By convention, resetbindings, reset- 
menus, and resetvariables head the list. _ . 


autoselect/noautoselect 


delta=pixels 


freeze/nofreeze 
grid/nogrid 
hiconpad=n 
hmenupad=n 
iconfont=fontname 


maxcolors=n 


normali/nonormali 


normalw/nonormalw 
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Places the menu cursor in the first menu item. If unspecified, the menu cur- 
sor is placed in the menu header when the menu is displayed. 


Indicates the number of pixels the cursor is moved before the action is inter- 
preted by the window manager as a command. (Also refer to the delta 
mouse action.) 


Locks all other client applications out of the server during certain window 
manager tasks, such as move and resize. 


Displays a finely-ruled grid to help you position an icon or window during 
resize or move operations. 


Indicates the number of pixels needed to pad an icon horizontally. The 
default is five pixels. 


Indicates the amount of space (in pixels), that each menu item is padded 
above and below in the text. . 


Names the font that is displayed within icons. Font names for a given server 
can be obtained using xIsfonts(1). | 


Limits the number of colors the window manager can use in a given invoca- 
tion. If set to zero, or not specified, uwm assumes no limit to the number of 
colors it can take from the colormap. Maxcolors counts colors as they are 
included in the file. 


Places icons created: with f.newiconify within the root window, even if they 
are placed partially off the screen. With nonormali the icon is placed 
exactly where the cursor leaves it. 


Places a window created with f.newiconify within the root window, even if 
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it is placed partially off the screen. With nonormalw the window is placed 
exactly where the cursor leaves it. . 


Moves a window n number of pixels, or a relative amount of space, depend- 
ing on whether pushabsolute or pushrelative is specified. Use this variable 
in conjunction with f.pushup, f.pushdown, f.pushright, or f.pushleft. 


pushabsolute/pushrelative Pushabsolute indicates that the number entered with push is equivalent to 


pixels. When an f.push (left, right, up, or down) function is called, the win- 
dow is moved exactly that number of pixels. 


Pushrelative indicates that the number entered with the push variable 
represents a relative number. When an f.push function is called, the win- 
dow is invisibly divided into the number of parts you entered with the push 
variable, and the window is moved one part. 


resetbindings, resetmenus, resetvariables 


Resets all previous function bindings, menus, and variables entries, 
specified in any startup file in the uwm search path, including those in the 
default environment. By convention, these variables are entered first in the 
startup file. 


resizefont=fontname Identifies the font of the indicator that displays in the corner of the window 


as you resize windows. See xIsfonts(1) for obtaining font names. 


reverse/noreverse Defines the display as black characters on a white background for the win- 


viconpad=n 
vmenupad=n 
volume=n 
zap/nozap 


BINDING SYNTAX 


"function=[control key(s)|:(context]:mouse events:" menu name 


dow manager windows and icons. 


Indicates the number of pixels to pad an icon vertically. Default is five pix- 
els. 


Indicates the amount of space in pixels that the menu is padded on the right 
and left of the text. 


Increases or decreases the base level volume set by the xset(1) command. 
Enter an integer from 0 to 7, 7 being the loudest. 


Causes ghost lines to follow the window or icon from its previous default 
location to its new location during a move or resize operation. 


vate 


The function and mouse events are required input. The menu name is required with the f.menu function 


definition only. 


Function 
f.beep 
f.circledown 


f.circleup 
f.continue 


f.focus 


f.iconify 
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Emits a beep from the keyboard. Loudness is determined by the volume variable. 
Causes the top window that is obscuring anomie window to drop to the bottom of the 
stack of windows. 

Exposes the lowest window that is obscured by other windows. 

Releases the window server display action after you stop action with the f.pause func- 
tion. . 
Directs all keyboard input to the selected window. To reset the focus to all windows, 
invoke f. focus from the root window. 


When imp plemented from a window, this function converts the window to its respective 
icon. When implemented from an icon, f.iconify converts the icon to its respective win- 
dow. | 

( 

| 


INTEGRATED SOLUTIONS . 2 


UWM (1) X Window System Reference Manual UWM (1) 

f.lower Lowers a window that is obstructing a window below it. 

f.menu Invokes a menu. Enclose ‘‘menu name’’ in quotes if it contains blank characters or 
parentheses. f.menu=[control key(s)]:[context |:mouse events:" menu name ' 

f.move Moves a window or icon to a new location, which becomes the default location. 

f.moveopaque Moves a window or icon to a new screen location. When using this function, the entire 
window or icon is moved to the new screen location. The grid effect is not used with 
this function. 

f.newiconify Allows you to create a window or icon and then position the window or icon in a new 
default location on the screen. 

f.pause Temporarily stops all display action. To release the screen and immediately update all 
windows, use the f.continue function. 

f.pushdown Moves a window down. The distance of the push is determined by the push variables. 

f.pushleft Moves a window to the left. The distance of the push is determined by the push vari- 
ables. | 

f.pushright Moves a window to the right. The distance of the push is determined by the push vari- 
ables. 

f.pushup Moves a window up. The distance of the push is determined by the push variables. 

f.raise Raises a window that is being obstructed by a window above it. 

f.refresh - Results in exposure events being sent to the window server clients for all unobscured or 
partially obscured windows. The windows do not refresh correctly if the exposure 
events are not handled properly. 

f.resize Resizes an existing window. Note that some clients, notably editors, react unpredictably 
if you resize the window while the client is running. 

f.restart Causes the window manager application to restart, rerecing the uwm search path and 
initializing the variables it finds. 

Control Keys 


By default, the window manager uses meta as its control key. It can also use ctrl, shift, lock, or null (no 
control key). Control keys must be entered in lowercase, and can be abbreviated as: c, 1, m,s for ctrl, lock, 
meta, and shift, respectively. 


You can bind one, two, or no control keys to a function. Use the bar (|) character to combine control keys. 


Note that client applications other than the window manager use the shift as a control key. If you bind the 
shift key to a window manager function, you can not use other client applications that require this key. 


Context 
The context refers to the screen location of the cursor when a command is initiated. When you include a 
context entry in a binding, the cursor must be in that context or the function will not be activated. The win- 
dow manager recognizes the following four contexts: icon, window, root, (null). 


The root context refers to the root, or background window, A (null) context is indicated when the context 
field is left blank, and allows a function to be invoked from any screen location. Combine contexts using 
the bar (|) character. 


Mouse Buttons 
Any of the following mouse buttons are accepted in lowercase and can be abbreviated as 1, m, or r, respec- 
tively: left, middle, right. 


With the specific button, you must identify the action of that button. Mouse actions can be: 


down Occurs when the specified button is pressed down. 
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up Occurs when the specified button is released. 


delta Indicates that the mouse must be moved the number of pixels specified with the delta variable 
before the specified function is invoked. The mouse can be moved in any direction to satisfy 
the delta requirement. 


MENU DEFINITION 
After binding a set of function keys and a menu name to f.menu, you must define the menu to be invoked, 
using the following syntax: 


menu = " menu name " { 
"item name" : "action" 


} 


Enter the menu name exactly the way it is entered with the f.menu function or the window manager will 
not recognize the link. If the menu name contains blank strings, tabs or parentheses, it must be quoted here 
and in the f.menu function entry. You can enter as many menu items as your screen is long. You cannot 
scroll within menus. 


Any menu entry that contains quotes, special characters, peas tabs, or strings of blanks must be 
enclosed in double quotes. Follow the item name by a colon (: ). 


Menu Action 
Window manager functions 
Any function previously described (e.g., famove or f.iconify). 


Shell commands 
Begins with an exclamation point (! ) and is set to run in background. You cannot include a 
new line character within a shell command. 


Text strings 
Text strings are placed in the window server’s cut buffer. 


Strings starting with an up arrow (* ) have a new line character appended to the string after the 
up arrow (* ) is stripped from it. 
Strings starting with a bar character (|) are copied as is after the bar character (|! ) is stripped. 
Color Menus © 
Use the following syntax to add color to menus: 


menu = "menu name" (color! :color2:color3:color4) { 
"item name" : (colorS :color6) :" action" 


} 


color1 Foreground color of the header. 

color2 Background color of the header. 

color3 _ Foreground color of the highlighter, the horizontal band of color that moves with the cursor 
within the menu. 


color4 Background color of the highlighter.’ 
color5 Foreground color for the individual menu item. 


1 September 1988 INTEGRATED SOLUTIONS 4 


UWM (1) X Window System Reference Manual UWM (1) 


color6 Background color for the individual menu item. 


Color Defaults 
Colors default to the colors of the root window under any of the following conditions: 


1) If you run out of colormap entries, either before or during an invocation of uwm. 


2) If you specify a foreground or background color that does not exist in the RGB color database of the 
server (see /usr/lib/X11/rgb.txt for a sample), both the foreground and background colors default to the root 
window colors. 


3) If you omit a foreground or background color, both the foreground and background colors default to the 
root window colors. 


4) If the total number of colors specified in the startup file exceeds the number specified in the maxcolors 
variable. 


5) If you specify no colors in the startup file. 


EXAMPLES 
The following sample startup file shows the default window manager options: 


# Global variables 

# 
resetbindings;resetvariables;resetmenus 
autoselect 

delta=25 


hiconpad=5 

hmenupad=6 

iconfont=oldeng 

menufont=timrom12b 

resizefont=9x15 

viconpad=5 

vmenupad=3 

volume=7 

# 

# Mouse button/key maps 

# 

#FUNCTION KEYS CONTEXT BUTTON MENU(if any) 
fmenu= meta: :leftdown :"WINDOW OPS" 

fmenu= ° meta: :middle down :"EXTENDED WINDOW OPS" 





fmove= meta :wli :right down 
f.circleup = meta :root :right down 

# 

# Menu specifications 

# 


* menu = "WINDOW OPS" { 
"(De)Iconify": —_f.iconify 


Move: f.move 
Resize: f.resize | 
Lower: f.lower 
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Raise: f.raise 


} 
menu = "EXTENDED WINDOW OPS" { 


Create Window: {xterm &” 
Iconify at New Position: f.lowericonify 
Focus Keyboard on Window: f.focus 
Freeze All Windows: f.pause 
Unfreeze All Windows: f.continue 
Circulate Windows Up: f.circleup 
Circulate Windows Down: f.circledown 
} 
RESTRICTIONS 
The color specifications have no effect on a monochrome system. 
FILES 
f/usr/lib/X11/uwm/system.uwmrc 
$HOME/.uwmre 
SEE ALSO 


X(1), Xserver(1), xset(1), xIsfonts(1) 
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WM (1) 
NAME | 
wm — a simple real-estate-driven window manager 
SYNOPSIS 
wm [-display display] 
DESCRIPTION 


Wm is a very primitive overlapping window manager for X11. It was developed to help with the debug- 
ging of the X11 server; we do not suggest that the user interface presented here is a desired one, and we do 
not suggest that you try to use this program on a regular basis. 


Wm decorates each mapped application window with a banner. The banner consists of four fields. Left- 
to-right, they are: 


Circulate button - A command button which causes the window to change its position in the stacking order. 


Title region - An area in which an applications name or other specified information is displayed. It is also 
used by the user to move the window. 


Iconize button - A command button which causes the window to be replaced by an icon. 
Resize button - A command button which allows the user to change the size of the window. 
Wm supports the following user actions: 


Raising or lowering a window in the stack of windows. 
Locating the pointer cursor in the Circulate box of a partially obscured window and clicking with any 
pointer button raises this window to the top of the stack of windows so that it is no longer obscured. 
Locating a pointer cursor in the Circulate box of a window which is currently on top of the window 
stack sends the window to the bottom of the stack. 


Iconizing a window. 

Locating the pointer cursor in the Iconize box and clicking any pointer button causes the window to 
be unmapped and the associated icon to become mapped. The icon appears at its last location, or, if 
this window has never been iconized, under the cursor. However, if the client program initially set 
an icon position in the WM_HINTS property, then that icon position is used instead as the initial icon 
position. To position an icon while iconizing the window, locate the cursor in the Iconize box and 
press down any pointer button. A rubber-band outline of the icon appears under the cursor. While 
holding down the pointer button, drag the cursor to the desired location for the icon. The outline fol- 

- lows the cursor on the screen. When the outline moves to the desired location for the icon, release 
-the pointer button. The client window becomes unmapped, and its icon appears at the desired loca- 
tion. To cancel this operation while the pointer button is down, click another pointer button. 


Deiconizing an icon. 
Locating the pointer cursor in an icon and clicking any pointer button causes the icon to be 
unmapped, and the associated window to become mapped. To cancel this operation while the pointer 
button is down, click another pointer button. 


Moving a window on the screen. 
Locating the pointer cursor in the area of the title region and pressing any pointer button causes a 
‘*rubber-band’’ outline of the window to appear. As you move (drag) the cursor (while holding 
down the pointer button), the outline moves accordingly. When the button is released, the window is 
repainted in the last location of the rubber-band outline. If you press another pointer button during 
the drag, the operation is cancelled, the rubber-band outline disappears, and the window is not 
moved. Note that a portion of the title region is constrained to remain on the screen. 


Resizing a window. 
Locating the pointer cursor in the resize box and pressing any pointer button initiates the spring- 
loaded resize mode. Then as soon a the cursor touches a border (while the pointer button is down), 
that border becomes a rubber-band line which follows the cursor until the button is released. If the 


1 September 1988 INTEGRATED SOLUTIONS . 1 


WM (1) X Window System Reference Manual WM (1) 


cursor then touches an adjacent border, that border also becomes a rubber-band line, and the window 
can be resized in two dimensions at once. If the cursor touches a border after having touched the 
opposite border, the first border touched reverts to its original location, and the other one becomes a 
rubber-band line which follows the cursor. If you press another pointer button during the drag, the 
operation is cancelled, the rubber-band outline disappears, and the window does not change size. 
Note that the pointer cursor has to touch a border to initiate the resize action. As in the move opera- 
tion, a protion of the title region is constrained to remain on the screen. 


Moving an icon on the screen 
To move an icon, press the Shift key and hold it, then position the pointer cursor in the icon, press 
any pointer button, and proceed dragging an outline of the icon around by moving the pointer cursor 
(with the pointer button down). When the outline moves to the desired position, release the pointer 
button and the Shift key. To cancel, click another pointer button during the drag; the icon will not 
move. 


NOTES FOR CLIENT PROGRAMS 
Wm uses the WM_ICON_NAME, WM_NAME, and WM_HINTS properties. It keeps the name in the 
Title region updated as the WM_NAME property changes. It keeps the name in the icon updated as the 
WM_ICON_NAME property changes; if a client does not set the WM_ICON_NAME property, wm will 
use the WM_NAME property for the icon name. Wm allows only text icons, and sets the icon sizes to 
accommodate the icon name. The maximum name length for both the icon name and the Title region name 
is 100 characters. 


Of the WMHints, wm ignores all but icon_x and icon_y, which it uses for initial icon placement. These 
need to be set by the client before its window is mapped, because wm reads them only once, when it first 
encounters the window. 


SEE ALSO 
X(1), Inter-Client Communication Conventions Manual 


BUGS 
This program does not necessarily implement the current window manager protcols. 


DIAGNOSTICS 
If you try to run wm while you are already running a window manager, wm will let you know. 
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NAME 
x10tox11 — X version 10 to version 11 protocol converter 


SYNTAX 
x10tox11 [-display host:display ] 

DESCRIPTION 
x10tox11 masquerades as an X Window System Version 10 server. It enables an X Version 10 client to 
run unchanged under X Version 11 by converting Version 10 requests into appropriate Version 11 
requests, and by converting all Version 11 events received from the server into Version 10 events. From 
the perspective of Version 10 clients, all Version 11 clients look like Version 10 clients; and from the per- 
spective of Version 11 clients, all Version 10 clients look like Version 11 clients. Hence, a Version 11 
window manager can manipulate Version 10 clients. 


This program does NOT use the X10 libnest ddx library. It does actual protocol translation, rather than 
simply using X11 graphics calls to implement X10 low level operations. As a result, it is both faster and 
more robust than the X10 Xnest server. 


OPTIONS 
—display host:display Specifies the host and server to use. 


SEE ALSO 
X(1), Xserver(1) 


BUGS 
There are limitations with respect to emulating Version 10 through a Version 11 server. See the README 
file in the sources for more details. 
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xbiff — mailbox flag for X 


SYNTAX 


xbiff [-toolkitoption] [-option] 


DESCRIPTION 


The xbiff program displays a little image of a mailbox. When there is no mail, the flag on the mailbox is 
down. When mail arrives, the flag goes up and the mailbox beeps. This program is nothing more than a 
wrapper around the Athena Mailbox widget. 


OPTIONS 


Xbiff accepts all of the standard X Toolkit command line options along with the additional options listed 


below: 
—help 


—update seconds 


—file flename 


Indicates that a brief summary of the allowed options should be printed on the 
Standard error. 


Specifies the frequency in seconds at which xbiff should update its display. If the 
mailbox is obscured and then exposed, it will be updated immediately. 


Specifies the name of the file which should be monitored. By default, it watches 
/usr/spool/maillusername, where username is your login name. 


The following standard X Toolkit command line arguments are commonly used with xbiff: 


—bg color 
—bd color 
—bw number 
-fg color 


—rv 


—geometry geometry 
—display display 


—xrm resourcestring 


X DEFAULTS 


Specifies the color to use for the background of the window. The default is white. 
Specifies the color to use for the border of the window. The default is black. 
Specifies the width in pixels of the border surrounding the window. 

Specifies the color to use for the foreground of the window. The default is black. 


Indicates that reverse video should be simulated by swapping the foreground and 
background colors. 


Specifies the prefered size and position of the mailbox window; see X(1). 
Specifies the X server to contact; see X(1). 


Specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. 


This program uses the Mailbox widget in the X Toolkit. It understands all of the core resource names and 


classes as well as: 
file (class File) 


width (class Width) 
height (class Height) 


Specifies the name of the file to monitor. The default is to watch 
/usr/spool/mail/username, where username is your login name. 


Specifies the width of the mailbox. 
Specifies the height of the mailbox. 


update (class Interval) Specifies the frequency in seconds at which the mail should be checked. 


foreground (class Foreground) 


Specifies the color for the foreground. The default is black since the core default 
for background is white. 


reverse Video (class ReverseVideo) 
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ENVIRONMENT 
DISPLAY To get the default host and display number. 


XENVIRONMENT _ To get the name of a resource file that overrides the global resources stored in the 
RESOURCE_MANAGER property. 


SEE ALSO 
X(1), xrdb(1), stat(2) 


BUGS 
The mailbox bitmaps are ugly. 
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NAME 

xcalc — scientific calculator for X 
SYNTAX 

xcale [-display display] [-bw pixels] [-stip] [-rv] [-rpn] [-analog] [-geometry geometry] 
DESCRIPTION 

Xcalc is a scientific calculator desktop accessory that can emulate a TI-30, an HP-10C, and a slide rule. 
OPTIONS 

—bw pixels Specifies the border width in pixels. 

—stip Indicates that the background of the calculator should be drawn using a stipple of 
the foreground and background colors. On monochrome displays this makes for a 
nicer display. 

-Irv Indicates that reverse video should be used. 

—rpn Indicates that Reverse Polish Notation should be used. In this mode the calculator 
will look and behave like an HP-10C. Without this flag, it will emulate a TI-30. 

—analog Indicates that a slide rule should be used. 

—geometry geometry Specifies the size and placement of the top level window. By default, the 
minimum size will be used. Note that your window manager may require you to 
place it explicitly anyway. 

—display display Specifies the X server to contact; see X(1). 

OPERATION 

Pointer Operation: The left mouse button is the only one used to operate the calculator. Pressing the 
AC key with the right mouse button terminates the calculator. 

Key Usage (Normal mode): 

The number keys, the +/- key, and the +, -, *, /, and = keys all do exactly what you 
would expect them to. It should be noted that the operators obey the standard 
rules of precedence. Thus, entering ‘‘3+4*5=’’ results in ‘‘23,’’ not ‘*35.’’ The 
parentheses can be used to override this. For example, ‘*(1+2+3)*(4+5+6)=”’ 
results in ‘“6*15=90.’’ The non-obvious keys are detailed below. 

1/x Replaces the number in the display with its reciprocal. 

x2 Squares the number in the display. 

SQRT Takes the square root of the number in the display. 

CE/C When pressed once, clears the number in the display without clearing the state of 
the machine. Allows you to re-enter a number if you screw it up. Pressing it twice 
clears the state, also. 

AC Clears everything: the display, the state, and the memory. Pressing it with the 
right mouse button turns off the calculator, in that it exits the program. 

INV Inverts the meaning of the function keys. See the individual function keys for 
details. | 

sin Computes the sine of the number in the display, as interpreted by the current DRG 
mode (see DRG below). If inverted, it computes the arcsine. 

cos Computes the cosine, or arccosine when inverted. 

tan Computes the tangent, or arctangent when inverted. 
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DRG Changes the DRG mode, as indicated by ““‘DEG,”’ ‘‘RAD,”’ or “‘GRAD?”’ at the 
bottom of the display. When in ‘‘DEG’’ mode, numbers in the display are taken 
as being degrees. In ‘‘RAD’’ mode, numbers are in radians, and in ““GRAD”’’ 
mode, numbers are in gradians. When inverted, the DRG key converts degrees to 
radians to gradians and vice-versa. Example: put the calculator into “‘DEG’’ 
mode, and type ‘*45 INV DRG.”’ The display should now show something along 
the lines of ‘*.785398,”’ which is 45 degrees converted to radians. 


e@ The constant ‘‘e’’ (2.7182818...). 

EE Used for entering exponential numbers. For example, to enter ‘*-2.3E-4’’ you’d 
type ‘2.3 +/- EE 4 +/-.”’ 

log Calculates the log (base 10) of the number in the display. When inverted, it raises 


**10.0’ to the number in the display. For example, typing ‘*3 INV log’’ should 
result in ‘*1000.”’ 


In Calcuates the log (base e) of the number in the display. When inverted, it raises 
‘‘e’’ to the number in the display. For example, typing ‘‘e In’’ should result in 
nel Weued 

yx Raises the number on the left to the power of the number on the right. For exam- 


ple ‘‘2 y*x 3 =”’ results in ‘‘8,’’ which is 2°3. For a further example, ‘“‘(1+2+3) 
yx (1+2) =’’ equals ‘*6 yx 3’” which equals ‘‘216.”’ 


PI The constant ‘‘pi’’ (3.1415927...). 


x! Computes the factorial of the number in the display. The number in the display 
must be an integer in the range 0-500, though, depending on your math library, it 
might overflow long before that. 


STO Copies the number in the display to the memory location. 

RCL Copies the number from the memory location to the display. 

SUM Adds the number in the display to the number in the memory location. 
EXC ; Swaps the number in the display with the number in the memory location. 
Key Usage (RPN mode): 


The number keys, CHS (change sign), +, = *, /, and ENTR keys all do exactly 
what you would expect them to. Many of the remaining keys are the same as in 
normal mode. The differences are detailed below. 


<- Is a backspace key that can be used while typing a number. It will erase digits 
from the display. 
ON Clears everything: the display, the state, and the memory. Pressing it with the 


right button ‘‘turns off’’ the calculator, in that it exits the program. 


INV Inverts the meaning of the function keys. This would be the ‘“‘f’’ key on an HP 
calculator, but xcale does not have the resolution to display multiple legends on 
each key. See the individual function keys for details. 


10*x Raises *‘10.0’’ to the number in the top of the stack. When inverted, it calculates 
the log (base 10) of the number in the display. 
e’x Raises ‘‘e’’ to the number in the top of the stack. When inverted, it calcuates the 


log (base e) of the number in the display. 


STO Copies the number in the top of the stack to a memory location. There are 10 
memory locations. The desired memory is specified by following the pressing of 
this key with the pressing of a digit key. 
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RCL Pushes the number from the specified memory location onto the stack. 

SUM Adds the number on top of the stack to the number in the specified memory loca- 
tion. 

xy Exchanges the numbers in the top two stack positions. 

Rv Rolls the stack downward. When inverted, it rolls the stack upward. 

blank These keys were used for programming functions on the HP11-C. Their func- 


tionality has not been duplicated here. 


KEYBOARD EQUIVALENTS 
If you have the pointer in the xcale window, you can use the keyboard to speed entry, as almost all of the 
calculator keys have a keyboard equivalent. The number keys, the operator keys, and the parentheses all 
have the obvious equivalent. The less-obvious equivalents are as follows: 


n: +/- !: x! 

p: PI e: EE 

1: In *: yx 

i: INV Ss: sin 

Cc: COS t: tan 

d: DRG BS, DEL: CE/C (‘‘<-”’ in RPN mode) 


CR: ENTR q: quit 

COLOR USAGE 
Xcalc uses a lot of colors, given the opportunity. In the default case, it just uses two colors (Foreground 
and Background) for everything. You can specify the colors used for the number keys, the operator (+- 
*/=) keys, the function keys, the display, and the icon. 


X DEFAULTS 

The program uses the routine XGetDefault(3X) to read defaults, so its resource names are all capitalized. 

BorderWidth Specifies the width of the border. The default is 2. 

ReverseVideo Indicates that reverse video should be used. 

Stipple Indicates that the background should be stippled. The default is on for mono- 
chrome displays, and off for color displays. 

Mode Specifies the default mode. Allowable values are rpn and analog. 

Foreground Specifies the default color used for borders and text. 

Background Specifies the default color used for the background. 


NKeyFore, NKeyBack Specifies the colors used for the number keys. 
OKeyFore, OKeyBack Specifies the colors used for the operator keys. 
FKeyFore, FKeyBack Specifies the colors used for the function keys. 
DispFore, DispBack Specifies the colors used for the display. 
IconFore, IconBack — Specifies the colors used for the icon, 


EXAMPLES 
If you’re running on a monochrome display, you shouldn’t need any Xdefaults entries for xcalc. Ona 
color display, you might want to try the following in normal mode: 


xcalc.Foreground: Black 
xcalc.Background: LightSteelBlue 
xcalc. NKeyFore: Black 
xcalc.NKeyBack: White 
xcalc.OKeyFore: Aquamarine 
xcalc.OKeyBack: DarkSlateGray 
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xcalc.FKeyFore: White 

xcalc.FKeyBack: #900 

xcalc.DispFore: Yellow 

xcalc.DispBack: #777 

xcalc.IconFore: Red 

xcalc.IconBack: White 
SEE ALSO 


X(1), xrdb(1), XGetDefault(3X) 


BUGS 
The calculator doesn’t resize. 


The slide rule may or may not work correctly. 


This application should really be implemented with the X Toolkit. It would make a very good example of 
a compound widget. 
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NAME 
xclock — analog / digital clock for X 


SYNTAX 
xclock [-toolkitoption] [-option] 


DESCRIPTION 
The xclock program displays the time in analog or digital form. The time is continuously updated at a fre- 
quency which may be specified by the user. This program is nothing more than a wrapper around the 


Athena Clock widget. 
OPTIONS 

Xclock accepts all of the standard X Toolkit command line options along with the additional options listed 

below: 

—help . Indicates that a brief summary of the allowed options should be printed on the 
standard error. 

—analog Indicates that a conventional 12-hour clock face with tick marks and hands should 
be used. This is the default. 

—digital Indicates that a 24-hour digital clock should be used. 

—chime Indicates that the clock should chime once on the half hour and twice on the hour. 

~hd color Specifies the color of the hands on an analog clock. The default is black. 

—hl color Specifies the color of the edges of the hands on an analog clock, and is only useful 
on color displays. The default is black. 

—update seconds Specifies the frequency in seconds at which xclock should update its display. If 


the clock is obscured and then exposed, it will be updated immediately. A value 
of less than 30 seconds will enable a second hand on an analog clock. The default 
is 60 seconds. 


—padding number Specifies the width in pixels of the padding between the window border and clock 
text or picture. The default is 10 on a digital clock and 8 on an analog clock. 


The following standard X Toolkit command line arguments are commonly used with xclock: 


—bg color Specifies the color to use for the background of the window. The default is white. 

—bd color Specifies the color to use for the border of the window. The default is black. 

—bw number Specifies the width in pixels of the border surrounding the window. 

-—fg color Specifies the color to use for displaying text. The default is black. 

—fn font Specifies the font to be used for displaying normal text. The default is 6x10. 

—rv Indicates that reverse video should be simulated by swapping the foreground and 
background colors. 


—geometry geometry Specifies the prefered size and position of the clock window. 
—display host:display Specifies the host and server to use. 


—xrm resourcestring Specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. 


X DEFAULTS 
This program uses the Clock widget in the X Toolkit. It understands all of the core resource names and 
Classes as well as: 


1 September 1988 INTEGRATED SOLUTIONS 1 


XCLOCK (1) X Window System Reference Manual XCLOCK (1) 


width (class Width) 
height (class Height) 
update (class Interval) 


foreground (class Foreground) 


hand (class Foreground) 
high (class Foreground) 
analog (class Boolean) 


chime (class Boolean) 
padding (class Margin) 


font (class Font) 


Specifies the width of the clock. 

Specifies the height of the clock. 

Specifies the frequency in seconds at which the time should be 
redisplayed. 


Specifies the color for the tick marks. Using the class specifies the 
color for all things that normally would appear in the foreground 
color. The default is black since the core default for background is 
white. 


Specifies the color of the insides of the clock’s hands. 
Specifies the color used to highlight the clock’s hands. 


Specifies whether or not an analog clock should be used instead of a 
digital one. The default is True. 


Specifies whether or not a bell should be rung on the hour and half 
hour. 

Specifies the amount of internal padding in pixels to be used. The 
default is 8. 


Specifies the font to be used for the digital clock. Note that variable 
width fonts currently will not always display correctly. 


reverse Video (class ReverseVideo) Specifies that the foreground and background colors should be 


ENVIRONMENT 
DISPLAY 


XENVIRONMENT 


SEE ALSO 


reversed. 


To get the default host and display number. 


To get the name of a resource file that overrides the global resources 
stored in the RESOURCE_MANAGER property. 


X(1), xrdb(1), time(3C), Athena Clock widget 


BUGS 


Xclock believes the system clock. 


When in digital mode, the string should be centered automatically. 


When specifying an offset, the grammar requires an hours field but if only minutes are given they will be 
quietly ignored. A negative offset of less than 1 hour is treated as a positive offset. 


Digital clock windows default to the analog clock size. 


Border color has to be explicitly specified when reverse video is used. 
When the update is an even divisor of 60 seconds, the second hand should always be on a multiple of the 


update time. 
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NAME 
xdpr — dump an X window directly to the printer 


SYNTAX 
xdpr [-option] 

DESCRIPTION 
Xdpr runs the commands xwd(1), xpr(1), and Ipr(1) to dump an X window, process it for a laser printer, 
and print it out. This is the easiest way to get a printout of a window. Xdpr, by default, prints the largest 
possible representation of the window on the output page. 


OPTIONS 
—Pprinter Specifies the name of the printer to be used. 
—display display - Specifies the X server to contact; see X(1). 
Any other arguments are passed as arguments to the xpr(1) command. 
SEE ALSO 
X(1), xwd(1), xpr(1), xwud(1), Ipr(1) 
ENVIRONMENT 
DISPLAY To get the default host and display number. 
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NAME 
xedit — simple text editor for X 
SYNTAX 
xedit [-toolkitoption] [filename] 
OPTIONS 
Xedit accepts all of the standard X Toolkit command line options, plus: 
filename Specifies the file that is to be loaded during start-up. If a file is not specified: xedit 
lets you load a file or create a new file after it has started up. 
DESCRIPTION 
Xedit provides a window consisting of the following three areas: 
Commands Menu Lists editing commands (for example, Undo or Search). 
Message Window Displays xedit messages. In addition, this window can be used as a scratch pad. 
Edit Window Displays the text of the file that you are editing or creating. 
COMMANDS 
Quit Quits the current editing session. If any changes have not been saved, xedit 
displays a warning message and allows you to save the file. 
Save Stores a copy of the original, unedited file in file.BAK, then overwrites the origi- 
nal file with the edited contents. 
Edit Allows the text displayed in the Edit window to be edited. 
Load Loads the specified file and displays it in the Edit window. 
Undo Undoes the last edit only. 
More Undoes each edit previous to the last edit, which must first be undone with the 
Undo command. 
Jump Advances the cursor from the beginning of the file to the text line that corresponds 
to the selected line number. 
<< Searches from the cursor back to the beginning of the file for the string entered in 


the Search input box. If you do not enter a string in the Search input box, xedit 
automatically copies the last string that you selected from any X application into 
the Search input box and searches for that string. 


Search >> Searches from the cursor forward to the end of the file for the string entered in the 
search input box. If you do not enter a string in the Search input box, xedit 
automatically copies the last string that you selected from any X application into 
the Search input box and searches for that string. 


Replace Replaces the last searched-for string with the string specified in the Replace input 
box. If no string has been previously searched for, searches from the insert cursor 
to the end of the file for the next occurrence of the search string and highlights it. 
All Repositions the cursor at the beginning of the file and replaces all occurrences 
of the search string with the string specified in the Replace input box. 


X DEFAULTS 
For xedit, the available class identifiers are: 


ButtonBox 
Command 
Scrollbar 
Text 
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For xedit, the available name identifiers are: 


All 

Edit 
EditWindow 
Jump 

Load 
Message Window 
More 

Quit 
Replace 
Save 

Undo 

xedit 


For xedit, the available resources are: 


EnableBackups 


background 


border . 
borderWidth 
font 
foreground 
geometry 


internalHeight 
internalWidth 


KEY BINDINGS 


Specifies that when edits made to an existing file are saved, xedit is to copy the 
original version of that file to file BAK before it saves the changes. If the value 
of this option is specified as off, a backup file is not created. 


Specifies the background color to be displayed in command buttons. The 
default is white. 


Specifies the border color of the xedit window. 

Specifies the border width, in pixels, of the xedit window. 

Specifies the font displayed in the xedit window. 

Specifies the foreground color of the xedit window. The default is black. 


Specifies the geometry (window size and screen location) to be used as the 
default for the xedit window. For information about the format of the geometry 
specification, see ARGUMENTS. 


Specifies the internal horizontal padding (spacing between text and button 
border) for command buttons. 


Specifies the internal vertical padding (spacing between text and button border) 
for command buttons. 


Each specification included in the .XtActions file modifies a key setting for the editor that xedit uses. When 
defining key specifications, you must use the following resource specification: 


text.EventBindings: .XtActions 
Each key specification assigns an editor command to a named key and/or mouse combination and has the 


format: 
key: function 
key Specifies the key or mouse button that is used to invoke the named function. 
function Specifies the function to be invoked when the named key is pressed. 

FILES . . 
*/.XtActions 
f/usr/lib/X11/.XtActions 
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SEE ALSO 
X(1), xrdb(1) 


RESTRICTIONS 
Large numbers of certain edit functions (for example, Undo or More) tend to degrade performance over 
time. If there is a noticeable decrease in response time, save and reload the file. 
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NAME 
xfd — font displayer for X 
SYNTAX 
xfd [-options] [fontname] 
OPTIONS 
—bw number Specifies the width of the window border in pixels. 
-rv Reverses the foreground and background. The default colors are black on white. 
—fw Overrides a previous choice of reverse video. The foreground and background 
colors will not be switched. 
—fg color determines the foreground color (the color of the text) on color displays. 
—bg color Determines the background color on color displays. 
—bd color Determines the color of the border on color displays. 
—bf fontname Specifies the font to be used for the messages at the bottom of the window. 
—tl title Specifies that the title of the displayed window should be title. 
—in iconname Specifies that the name of the icon should be iconname. 
—icon filename Specifies that the bitmap in file filename should be used for the icon. 
—verbose Specifies that verbose mode should be used. 
—gray Specifies that a gray background should be used. 
—start charnum Specifies that character number charnum should be the first character displayed. 
—geometry geometry Specifies an initial window geometry; see X(1). 
—display display Specifies the display to use; see X(1). 
DESCRIPTION 


Xfd creates a window in which the characters in the named font are displayed. The characters are shown 
in increasing order from left to right, top to bottom. The first character displayed at the top left is character 
number 0 unless the -start option is supplied in which case the character with the number given in the 
-start option is used. 


The characters are displayed in a grid of boxes, each large enough to hold any character of the font. If the 
-gray option is supplied, the characters are displayed using XDrawImageString(3X) using the foreground 
and background colors on a gray background. This permits determining exactly how 
XDrawImageString(3X) draws any given character. If -gray is not supplied, the characters are simply 
drawn using the foreground color on the background color. 


All the characters in the font may not fit in the window at once. To see additional characters, click the right 
mouse button on the window. This causes the next window full of characters to be displayed. Clicking the 
left mouse button on the window causes the previous window full of characters to be displayed. Xfd beeps 
if an attempt is made to.go back past the Oth character. 


Note that if the font is an 8-bit font, the characters 256-511 (0x100-Ox1ff), 512-767 (0x200-0x2ff), ... 
displays exactly the same as the characters 0-255 (0x00-Oxff). Xfd, by default, creates a window 
sufficiently large enough to display the first 256 characters using a 16x16 grid. In this case, there is no 
need to scroll window fulls forward or backward in order to see the entire contents of an 8-bit font. This 
window may not fit on the screen. 

Clicking the middle button on a character causes that character’s number to be displayed in both decimal 
and hexidecimal at the bottom of the window. If verbose mode is selected, additional information about 
that particular character is displayed as well. The displayed information includes the width of the character, 
its left bearing, right bearing, ascent, and descent. If verbose mode is selected, typing “*<’’ or “‘>’’ into the 
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window displays the minimum or maximum values respectively taken on by each of these fields over the 
entire font. 


The font name is interpreted by the X server. To obtain a list of all the fonts available, use xlsfonts(1). 
If no font name is given on the command line, Xfd displays the font “‘fixed.’’ 
The window stays around until the xfd process is killed or “‘q,’’ *‘Q,’’ “* ’’, or ctrl-c is typed into the xfd 


window. 
X DEFAULTS 
The xfd program uses the routine XGetDefault(3X) to read defaults, so its resource names are all capital- 
ized. 
BorderWidth Sets the border width of the window. 
BorderColor Sets the border color of the window. 
ReverseVideo If ‘‘on,’’ reverses the definition of foreground and background color. 
Foreground Sets the foreground color. | 
Background Sets the background color. 
BodyFont Sets the font to be used in the body of the window (i.e., for messages, etc.). This 
. is not the font that xfd displays, just the font it uses to display information about 
the font being displayed. 
IconName Sets the name of the icon: 
IconBitmap Sets the file we should look in to get the bitmap for the icon. 
Title Sets the title to be used. 
SEEALSO] 
X(1), xisfonts(1), xrdb(1), XDrawImageString(3X), XGetDefault(3X) 
ENVIRONMENT 
DISPLAY To get the default host and display to use. 


XENVIRONMENT _ To get the name of a resource file that overrides the global resources stored in the 
RESOURCE_MANAGER property. 


BUGS 
It should display the name of the font somewhere. 


It should be rewritten to use the X Toolkit. 
It should skip over pages full of non-existant characters. 
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xhost — server access control program for X 


SYNTAX 
xhost [[+-] hostname] 


DESCRIPTION 


The xhost program is used to add and delete hosts to the list of machines that are allowed to make connec- 
tions to the X server. This provides a rudimentary form of privacy control and security. It is only sufficient 
for a workstation (single user) environment, although it does limit the worst abuses. Environments which 
require more sophisticated measures should use the hooks in the protocol for passing authentication data to 


the server. 


The server initially allows network connections only from programs running on the same machine or from 
machines listed in the file /etc/X*.hosts (where * is the display number of the server). The xhost program 
is usually run either from a startup file or interactively to give access to other users. 


Hostnames that are followed by two colons (::) are used in checking DECnet connections; all other host- 
names are used for TCP/IP connections. 


OPTIONS 


Xhost accepts the following command line options described below. For security, the options that effect 
access control may only be run from the same machine as the server. 


[+]hostname 

—hostname 

+ 

nothing 
FILES 

/etc/X* hosts 
SEE ALSO 

_X(1), Xserver(1) 

ENVIRONMENT 

DISPLAY 
BUGS | 


The given hostname (the plus sign is optional) is added to the list of machines that 
are allowed to connect to the X server. 


The given hostname is removed from the list of machines that are allowed to con- 
nect to the server. Existing connections are not broken, but new connection 
attempts are denied. Note that the current machine is allowed to be removed; 
however, further connections (including attempts to add it back) are not permitted. 
Resetting the server (thereby breaking all connections) is the only way to allow 
local connections again. 


Access is granted to everyone, even if they aren’t on the list of allowed hosts (i.e., 
access control is tured off). 


Access is restricted to only those machines on the list of allowed hosts (i.e., access 
control is turned on). 


If no command line arguments are given, the list of hosts that are allowed to con- 
nect is printed on the standard output along with a message indicating whether or 
not access control is currently enabled. This is the only option that may be used 
from machines other than the one on which the server is running. 


To get the default host and display to use. 


You can’t specify a display on the command line because —display is a valid command line argument 
(indicating that you want to remove the machine named ‘‘display’’ from the access list). 
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NAME 

xinit — X Window System initializer 
SYNTAX 

xinit [[client] options] [-- [server] [display] options] 
DESCRIPTION 


The xinit program is used to start the X Window System server and a first client program (usually a termi- 
nal emulator) on systems that cannot start X directly from /etc/init or in environments that use multiple 
window systems. When this first client exits, xinit kills the X server and then terminates. 


Unless otherwise specified on the command line, xinit assumes that there are programs called ‘‘X’’ and 
**xterm’’ in the current search path. It starts the server on display 0 and then runs an xterm using the fol- 
lowing command line: 


xterm -geometry +1+1 -n login -display unix:0 


(Systems that don’t support UNIX domain sockets are started with hostname:0 instead.) 


An alternate client and/or server may be specified on the command line. The desired client program and its 
arguments’ should be given as the first command line arguments to xinit. To specify a particular server 
command line, append a double dash (--) to the xinit command line (after any client and arguments) fol- 
lowed by the desired server command. 


Both the client program name and the server program name must begin with a slash (/ ) or a period (. ). 
Otherwise, they are treated as an argument to be appended to their respective startup lines. This makes it 
possible to add arguments (for example, foreground and background colors) without having to retype the 
whole command line. 


If an explicit server name is not given and the first argument following the double dash (--) is a digit, xinit 
uses that number as the display number instead of zero. All remaining arguments are appended to the 
server command line. 


Since the default client is xterm(1), arguments entered after xinit are simply appended as further options to 
the default xterm command line. 


EXAMPLES 
xinit -geometry =80x65+10+10 -fn 8x13 -j -fg white -bg navy 


xinit -e widgets -- Xsun -l -c 


xinit rsh fasthost cpupig -display workstation:1 -- 1 -a2 -t 5 


SEE ALSO 
X(1), Xserver(1), xterm(1) 


1 September 1988 INTEGRATED SOLUTIONS 1 


XIS (1) X Window System Reference Manual XIS (1) 


NAME 
xis — server for X.11 


SYNTAX 
xis [ option ] ... 

DESCRIPTION 
xis is the server for Version 11 of the X Window System on Integrated Solutions workstations. It is nor- 
mally started by xinit(1), or by a shell script run from an interactive shell. Note that you probably need to 
give command line options to xinit(1) in order to get it to run theserver with the desired command line 
options, and to run xterm(1) with the desired options, display, etc. See the manpage for xinit(1). 


CONFIGURATIONS 
display workstation hardware. It requires a keyboard and mouse. 


OPTIONS 
The standard X11 server command line options are used. These options are described under Xserver(1). 


You can exit the server by entering exit at the command line prompt in the console window. Note that this 
terminate the server but that there is no guarantee that all the existing processes will die. Refer to the X// 
Window Manager’ s Guide for a more complete explanation. 

FILES 
/usr/bin/X11/Xis 

SEE ALSO 
Xserver(1) 
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NAME 
xload ~— load average display for X 


SYNTAX 
xload [-toolkitoption] [-scale integer] [-update seconds] 


DESCRIPTION 
The xload program displays a periodically updating histogram of the system load average. This program is 
nothing more than a wrapper around the Athena Load widget. 


OPTIONS - 
Xload accepts all of the standard X Toolkit command line options along with the additional options listed 
below: 

—scale integer Specifies the minimum number of tick marks in the histogram, where 
one division represents one load average point. If the load goes 
above this number, xload will create more divisions, but it will never 

use fewer than this number. The default is 1. 
—update seconds Specifies the frequency in seconds at which xload updates its display. 


Expose events will cause automatic updating. The minimum as well 
as default time is 5 seconds. — 


The following standard X Toolkit arguments are commonly used with xload. 


~—bd color Specifies the border color. The default color is black. 

—bg color Specifies the background color. The default color is white. 

—bw pixels Specifies the width in pixels of the border around the window. The 
default value is 2. . 

—fg color Specifies the graph color. The default color is black. 

~fn fontname Specifies the font to be used in displaying the name of the host whose 
load is being monitored. The default is 6x10. 

-rv Indicates that reverse video should be simulated by swapping the 
foreground and background colors. 

—geometry geometry Specifies the prefered size and postion of the window; see X(1). 

—display display Specifies the X server to contact; see X(1). 

~xrm resourcestring Specifies a resource string to be used. This is especially useful for 


setting resources that do not have separate command line options. 


X DEFAULTS 
This program uses the Load widget in the X Toolkit. It understands all of the core resource names and 
classes as well as: 


width (class Width) Specifies the width of the load average graph. 
height (class Height) Specifies the height of the load average graph. 
update (class Interval) Specifies the frequency in seconds at which the load should be 
redisplayed. 
scale (class Scale) Specifies the initial number of ticks on the graph. The default is 1. 
minScale (class Scale) Specifies the minimum number of ticks that will be displayed. The 
default is 1. 


foreground (class Foreground) Specifies the color for the graph. Using the class specifies the color 
for all things that normally would appear in the foreground color. 
The default is black since the core default for background is white. 
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label (class Label) . Specifies the label to use on the graph. The default is the hostname. 


font (class Font) Specifies the font to be used for the label. The default is ‘‘fixed.’’ 
reverse Video (class ReverseVideo) Specifies that the foreground and background should be reversed. 
ENVIRONMENT 
DISPLAY To get the default host and display number. 
XENVIRONMENT To get the name of a resource file that overrides the global resources 
stored in the RESOURCE_MANAGER property. 
SEE ALSO 
X(1), xrdb(1), mem(4), Athena Load widget 
DIAGNOSTICS 
Unable to open display or create window. 
Unable to open /dev/kmem. 


Unable to query window for dimensions. 
Various X errors. 


BUGS 
This program requires the ability to open and read /dev/kmem. On most systems, this requires the suid bit 
set with root ownership or the sgid bit set and membership in the same group as /dev/kmem. 


Reading /dev/kmem is inherently non-portable. 
Border color has to be explicitly specified when reverse video is used. 
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NAME 
xlogo — X Window System logo 
SYNTAX 
xlogo [-toolkitoption] 
DESCRIPTION 
The xlogo program displays the X Window System logo. This program is nothing more than a wrapper 
around the Athena Logo widget. 
OPTIONS 
Xlogo accepts all of the standard X Toolkit command line options, of which the following are commonly 
used: 
—bg color’ Specifies the color to use for the background of the window. The default is white. 
A correct color for the background is maroon. . 
—bd color — Specifies the color to use for the border of the window. The default is black. 
—bw number Specifies the width in pixels of the border surrounding the window. 
~fg color Specifies the color to use for displaying the logo. The default is black. A correct 
color for the background is silver, which you can approximate with a shade of 
gray, like #aa9. 
-rv Indicates that reverse video should be simulated by swapping the foreground and 
background colors. 
—geometry geometry Specifies the prefered size and position of the logo window; see X(1). 
—display display Specifies the X server to contact; see X(1). 


—xrm resourcestring Specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. 


X DEFAULTS 
This program uses the Logo widget in the X Toolkit. It understands all of the core resource names and 
classes as well as: 
width (class Width) Specifies the width of the logo. 
height (class Height) Specifies the height of the logo. 


foreground (class Foreground) 
Specifies the color for the logo. The default is black since the core default for 
background is white. 


reverse Video (class Reverse Video) 
Specifies that the foreground and background should be reversed. 


ENVIRONMENT 
DISPLAY To get the default host and display number. 


XENVIRONMENT To get the name of a resource file that overrides the global resources stored in the 
RESOURCE_MANAGER property. 


SEE ALSO | 
X(1), xrdb(1), Athena Logo widget 
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NAME 
xlsfonts — server font list displayer for X 


SYNTAX 
xlsfonts [-options] [pattern] 


DESCRIPTION 
XIsfonts lists the fonts that match the given pattern. The wildcard character ‘‘*’’ may be used to match 
any sequence of characters (including none), and ‘‘?’’ to match any single character. If no pattern is given, 
“*x?? is assumed. 


The ‘‘*’’ and ‘‘?’’ characters must be quoted to prevent them from being expanded by the shell. 


OPTIONS 
—display host:display Specifies the host and server to use. 
-I Indicates that a long listing should be generated for each font. 
—m Indicates that long listings should also print the minimum and maximum bounds 
of each font. 
—-C Indicates that listings should use multiple columns. 
-1 . Indicates that listings should use a single column. 
SEE ALSO 
X(1), Xserver(1), xset(1), xfd(1) 
ENVIRONMENT 
DISPLAY To get the default host and display to use. 
BUGS . 


Doing ‘‘xlsfonts -1’’ can tie up your server for a very long time. This is really a bug with single-threaded, 
non-preemptible servers, not with this program. 
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NAME 
xmh — X window interface to the mh Mail Handler 


SYNTAX 
xmh [-path mailpath] [-initial foldername] [-flag] [-toolkitoption] 


DESCRIPTION 
The xmh program provides a window-oriented front end to the mh Mail Handler. It is designed to take 
advantage of a large graphical display and pointer. It will not function on an ordinary terminal at all. 


Xmbh consists of user-interface code only. To actually do things with your mail, it makes calls to the mh 


package. 
OPTIONS 

-display host:display Specifies the host and server to use. 

-path mailpath Specifies the path to the desired mail file. The default is 
/usr!spoollmail/username. . 

-initial foldername Specifies which folder message list should be displayed on startup. The default is 
**inbox.”’ 

-flag Indicates (if icon is set) that mail is pending or has been received. 


INSTALLATION 
. The current version of xmh requires that the user is already set up to use mA, version 6. To do so, see if 
there is a file called .mh_profile in your home directory. If you do, check to see if it contains a line that 
Starts with ‘‘Current-Folder.’’ If it does, then you’ve been using version 4 or earlier of mh; to convert to 
version 6, you must remove that line. (Failure to do so causes spurious output to stderr, which can hang 
xmh depending on your setup.) 


If you do not already have a .mh_profile, you can create one (and everything else you need) by typing 
**inc’’ to the shell. 


For more information, refer to the mh documentation. 


RUNNING XMH 
Run xmh as you would any other X application (e.g., xterm). It accepts a command-line display (of the 
form ‘‘-display host:display’’); the default display is specified in the environment variable DISPLAY. 


It is best to run xmh while reading this man page so that you see first hand the things being described. 


BASIC SCREEN LAYOUT 
Xmbh starts out with a single screen. There are 6 or 7 areas on the screen: 


— A list of your folders. (New users of mh will see only inbox here.) 
— A list of the global and folder-oriented commands. 

'— A list of the messages in one of your folders (initially, this will show the messages in inbox). 
- A list of the message-oriented commands. . . 
— A view of one of your messages. (Initially this is blank.) 

-  Alist of commands for the message being viewed. 
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And, there will possibly be: 


— A list of message-sequences defined for this folder. This appears just below the list of messages in 
this folder. (Message-sequences are discussed below; if you don’t know what they are, then you 
won’t have any.) 


XMH AND THE TOOLKIT 
Xmh uses the X Toolkit. Many of the features described below (scrollbars, buttonboxes, etc.) are actually 
part of the Toolkit, and are described here only for completeness. For more information, see the Toolkit 
documentation in your core documentation set. 


SCROLLBARS 
Some parts of the screen have a vertical area on the left containing.a grey bar. This area is a scrollbar. 
They are used whenever the data in a window takes up more space than can be displayed. The grey bar 
indicates what portion of your data is visible. Thus, if the entire length of the area is grey, then you are 
looking at all your data. If only the first half is grey, then you are looking at the top half of your data. 


You can use the pointer in the scrollbar to change what part of the data is visible. If you click with button 2 
(middle mouse button), then the top of the grey area moves to where the pointer is, and the corresponding 
portion of data is displayed. If you hold down the middle button, you can drag around the grey area. This 
makes it easy to get to the top of the data: just press and hold the middle mouse button, drag off the top of 
the scrollbar, and release. 


If you click with button 1 (left mouse button), then the data to the right of the pointer scrolls to the top of 
the window. If you click with pointer button 3 (right mouse button), then the data at the top of the window 
scrolls down to where the pointer is. 


BUTTONBOXES 
Any area consisting of many words or short phrases, each enclosed in a box, is called a buttonbox. Each 
box is actually a button that you can press by moving the pointer onto it and pressing pointer button 1. If a 
given buttonbox has more buttons in it than can fit, it is displayed with a scrollbar, so you can always scroll 
to the button you want. 


ADJUSTING THE RELATIVE SIZES OF AREAS 
If you’re not satisfied with the size of the various areas on the screen, they can easily be changed. Near the 
right edge of the border between each region is a black box, called a grip. Simply point to that grip with 
the pointer, press a pointer button, drag up or down, and release. Exactly what happens depends on which 
pointer button you press. 


If you drag with the middle mouse button (pointer button 2), then only that border will move. This mode is 
simplest to understand, but is probably the least useful. 


If you drag with the left mouse button (pointer button 1), then you are adjusting the size of the window 
_ above. Xmh will attempt to compensate by adjusting some window below it. . 


If you drag with the right mouse button (pointer button 3), then you are adjusting the size of the window 
below. Xmh will attempt to compensate by adjusting some window above it. 


All windows have a mininum and maximum size; you will never be allowed to move a border past the 
point where it would make a window have an invalid size. 
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The selected folder is whichever foldername is highlighted in the top buttonbox. Note that this is not 
necessarily the same folder that is being viewed. To change the selected folder, just press on the desired 


folder button. 


GENERAL COMMANDS AND FOLDER COMMANDS 
The second buttonbox contains commands of a global nature: 


close 
compose 


open 


openInNew 


create 


delete 


(or Quit XMH) Exits xmh, after first checking that you won’t lose any changes. 


(or Compose Message) Composes a new message. A new window is brought up; 
for a description of it, see COMPOSITION WINDOWS below. 


(or Open Folder) Display the data in the selected folder. The selected folder also 
becomes the viewed folder. . 


(or Open Folder in New Window) Creates a new screen and displays the selected 
folder in that screen. Note, however, that you may not display the same folder in 
more than one screen at a time. 


(or Create Folder) Create a new folder. You will be prompted for a name for the 
new folder; to enter the name, point the pointer at the blank box provided and 
type. Hit the Confirm button when finished, or hit Abort to cancel this operation. 


(or Delete Folder) Destroy the selected folder. You are asked to confirm this 
action (see CONFIRMATION WINDOWS). 


HIGHLIGHTED MESSAGES, SELECTED MESSAGES 

AND THE CURRENT MESSAGE . 
It is possible to highlight a set of messages in the list of messages for the viewed folder. To highlight a 
message, just click on it with pointer button 1. To highlight a range of messages, click on the first one with 
pointer button 1 and on the last one with pointer button 3. 


The selected messages are the same as the highlighted messages, if any. If no messages are highlighted, 
then the selected messages are considered the same as the current message. 


The current message is indicated by a *‘+’’ next to the message number. It usually corresponds to the mes- 
sage currently being viewed. 


MESSAGE COMMANDS 


The third buttonbox (fourth if you have message-sequences displayed) contains commands to deal with 


messages: 


inc 
next 


prev 
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(or Incorporate New Mail) Add any new mail received to your inbox folder, and 
set the current message to be the first new message. (This button is selectable 
only if “‘inbox’’ is the folder being viewed.) 


(or View Next Message) View the first selected message. If no messages are 
highlighted, view the current message. If the current message is already being 
viewed, view the first unmarked message after the current message. 


(or View Previous Message) View the last selected message. If no messages are 
highlighted, view the current message. If the current message is already being 
viewed, view the first unmarked message before the current message. 
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delete 


move 


copy 


unmark 


viewNew 


reply 
forward 


useAsComp 


commit 


print 


pack 
sort 


rescan 


pick 
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(or Mark Deleted) Mark the selected messages for deletion. If no messages are 
highlighted, then this will automatically display the next unmarked message. 


(or Mark Move) Mark the selected messages to be moved into the current folder. 
(if the current folder is the same as the viewed folder, this command will just 
beep.) If no messages are highlighted, then this will automatically display the 
next unmarked message. 


(or Mark Copy) Mark the selected messages to be copied into the current folder. 
Cif the current folder is the same as the viewed folder, this command will just 
beep.) 

Remove any of the above three marks from the selected messages. 


(or View in New Window) Create a new window containing only a view of the 
first selected message. 


Create a composition window in reply to the first selected message. 


Create a composition window whose body is initialized to be the contents of the 
selected messages. 


(or Use as Composition) Create a composition window whose body is initialized 
to be this message. Note that any changes you make in the composition are also 
saved in this message. This function is meant to be used with the ‘‘drafts’’ folder 
(see COMPOSITION WINDOWS below). 


(or Commit Changes) Execute any deletions, moves, and copies that have been 
marked in this folder. 


Print the selected messages. Xmh normally prints by invoking the enscript(1) 
command, but you may change the command it uses (see CUSTOMIZING 
below). 


(or Pack folder) Renumber the messages in this folder so they start with 1 and 
increment by 1. 


(or Sort folder) Sort the messages in this folder in chronological order. As a side 
effect, this also packs the folder. 


(or Force Rescan) Rebuild the list of messages. This can be used whenever you 
suspect xmh’s idea of what messages you have is wrong. (In particular, this is 
useful if you ever change things using straight mh commands without using xmh.) 


(or Pick Messages) Define a new message-sequence (see MESSAGE- 
SEQUENCES below). 


The following buttons will appear but will be sensitive only if the current folder has any message- 
sequences defined (see MESSAGE-SEQUENCES below). 


openSeq 


addToSeq 


removeFromSeq 


deleteSeq 
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(or Open Sequence) Change the viewed sequence to be the same as the selected 
sequence, 


(or Add to Sequence) Add the selected messages to the selected sequence. 


(or Remove from sequence): Remove the selected messages from the selected 
sequence. 


(or Delete Sequence) Remove the selected sequence entirely. Note the messages 
themselves are not affected; they aid are no longer grouped together as a 
message-sequence. 


INTEGRATED SOLUTIONS 4 


XMH(1) X Window System Reference Manual XMH(1) 


VIEW WINDOWS 
The commands in these windows are the same as the message commands by the same name, except instead 
of affecting the selected messages, they affect the viewed message. In addition, there is the ‘‘edit’’ button, 
which allows you to edit the message being viewed. While editing, the “‘edit’’ button will change to a 
**save’’ button which should be pressed to save your edits. 


COMPOSITION WINDOWS . 
Aside from the normal text editing functions, there are three command buttons associated with composition 


windows: 

abort (or Abort Comp) Abort this composition window. If changes have been made, 
you will be asked to confirm losing them. 

send Send this composition. If any errors appear in the message header, you will 
receive a mail message containing this composition and a description of the error. 

save Save this composition in your drafts folder; (if you do not have a folder named 


‘*drafts,’’ one will be created) then you can safely close the composition. At some 
future date, you can continue working on the composition by opening your drafts 
folder, selecting the message, and using the ‘‘Use as Composition’’ command. 


TEXT EDITING COMMANDS 
All of the text editing commands are actually defined by the Text widget in the X Toolkit. The commands 
may be bound to different keys than the defaults described below through the standard X Toolkit key re- 
binding mechanisms. See the X Toolkit and Athena Widgets documentation for more details. 


Whenever .you are asked to enter any text, you will be using a standard text editing interface. Various con- 
trol and meta keystroke combinations are bound to a somewhat Emacs-like set of commands. In addition, 
the pointer buttons may be used to select a portion of text or to move the insertion point in the text. Press- 
ing pointer button 1 causes the insertion point to move to the pointer. Double-clicking button 1 selects a 
word, triple-clicking selects a paragraph, and quadruple-clicking selects everything. Any selection may be 
extended in either direction by using pointer button 3. 


In the following, a line refers to one displayed row of characters in the window. A paragraph refers to the 
text between carriage returns. Text within a paragraph is broken into lines based on the current width of 
the window. 


The following keystroke combinations are defined: 
Control-A Move to the beginning of the current line. 


Control-B, Control-H, Backspace 
. Move backward one character. 


Control-D Delete the next character. 
Control-E Move to the end of the current line. 
Control-F ' Move forward one character. 


Control-J, LineFeed Create a new paragraph with the same indentation as the previous one. 
Control-K Kill the rest of this line. 

Control-L Repaint this window. 

Control-M, Return Create a new paragraph. 
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Control-N Move down to the next line. 

Control-O Break this paragraph into two. 

Control-P Move up to the previous line. 

Control-V Move down to the next screenfull of text. 

Control-W Kill the selected text. 

Control-Y _ Insert the last killed text. 

Control-Z Scroll the text one line up. 

Meta-< Move to the beginning of the document. 

Meta-> Move to the end of the document. 

Meta-[ Move backward one paragraph. 

Meta-] Move forward one paragraph. 

Meta-B Move backward one word. 

Meta-D Kill the next word. 

Meta-F Move forward one word. 

Meta-H, Meta-Delete Kill the previous word. 

Meta-I Insert a file. If any text is selected, use the selected text as the filename. Other- 
wise, a box will appear in which you can type the desired filename. 

Meta-V Move up to the previous screenfull of text. 

Meta-Y Insert the last selected text here. Note that this can be text selected in some other 


text subwindow. Also, if you select some text in an xterm window, it may be 
inserted in an xmh window with this command. This action is equivalent to press- 


ing pointer button 2. 
Meta-Z Scroll the text one line down. 
Delete Delete the previous character. 


CONFIRMATION WINDOWS 
Whenever you press a button that may cause you to lose some work or is otherwise dangerous, a window 
will appear asking you to confirm the action. This window will contain an ‘‘Abort’’ button and a 
**Confirm’’ button. Pressing the ‘‘Abort’’ button cancels the operation, and pressing the ‘‘Confirm’’ but- 
ton will proceed with the operation. (A very handy shortcut exists: if you press the offending button again, 
it will be interpreted as a “‘Confirm.’’ If you press any other command button, it will be interpreted as an 
** Abort.”’) 


MESSAGE-SEQUENCES 
An mh message sequence is just a set of messages associated with some name. They are local to a particu- 
lar folder; two different folders can have sequences with the same name. In all folders, the sequence ‘‘all”’ 
is predefined; it consists of the set of all messages in that folder. (The sequence ‘‘cur’’ is also usually 
defined for every folder; it consists of only the current message. Xmbh hides ‘‘cur’’ from the user, instead 
placing a ‘‘+’’ by the current message. Also, xmh does not support the ‘“‘unseen’’ sequence, so that one is 
also hidden from the user.) 


The message sequences for a folder are displayed as buttons containing the names of the sequences 


- (including one for ‘‘all’’). The table of contents (aka “‘toc’’) is at any one time displaying one message 
sequence. This is called the ‘‘viewed sequence’’; if it’s not “‘all,’’ its name will be displayed in the title bar 
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just after the folder name. Also, at any time one of the sequence buttons will be highlighted. This is called 
the “‘selected sequence.’’ Note that the viewed sequence and the selected sequence are not necessarily the 
same. (This all pretty much corresponds to the way the folder buttons work.) 


The Open Sequence, Add to Sequence, Remove from Sequence, and Delete Sequence buttons are active 
only if the viewed folder contains message-sequences. 


Note that none of the above actually effect whether a message is in the folder. Remember that a sequence 
is a set of messages within the folder; the above operations just affect what messages are in that set. 


To create a new sequence, press the ‘‘Pick’’ button. A new window will appear, with lots of places to 
enter text. Basically, you can describe the sequence’s initial set of messages based on characteristics of the 
message. Thus, you can define a sequence to be all the messages that were from a particular person, or 
with a particular subject, and so on. You can also connect things up with boolean operators, so you can 
select all things from ‘‘weissman’’ with the subject ‘‘xmh.”’ 


Hopefully, the layout is fairly obvious. The simplest cases are the easiest: just point to the proper field and 
type. If you enter in more than one field, it will only select messages which match all non-empty fields. 


The more complicated cases arise when you want things that match one field or another, but not necessarily 
both. That’s what all the ‘‘or’’ buttons are for. If you want all things with the subject ‘‘xmh’’ or “‘xterm,”’ 
just press the ‘‘or’’ button next to the “‘Subject:’’ field. Another box will appear where you can enter 
another subject. 


If you want all things either from ‘‘weissman’’ or with subject ‘‘xmh,”’’ but not necessarily both, select the 
**-Or-’’ button. This will essentially double the size of the form. You can then enter “‘weissman’’ in a 
from: box on the top half, and ‘*xmh’’ in a subject: box on the lower part. 


If you ever select the ae button, then only those messages that don’t match the fields on that row are 
included. 


Finally, in the bottom part of the window will appear several more boxes. One is the name of the sequence 
you’re defining. (It defaults to the name of the selected sequence when ‘‘Pick’’ was pressed, or to ‘‘temp”’ 
if ‘‘all’’ was the selected sequence.) Another box defines which sequence to look through for potential 
members of this sequence; it defaults to the viewed sequence when ‘‘Pick’’ was pressed. 


Two more boxes define a date range; only messages within that date range will be considered. These dates 
must be entered in 822-style format: each date is of the form ‘‘dd mmm yy hh:mm:ss zzz,’’ where dd is a 
one or two digit day of the month, mmm is the three-letter abbreviation for a month, and yy is a year. The 
remaining fields are optional: hh, mm, and ss specify a time of day, and zzz selects a time zone. Note that 
if the time is left out, it defaults to midnight; thus, if you select a range of ‘“7 nov 86’’ - “‘8 nov 86,”” you 
will only get messages from the 7th, as all messages on the 8th will have arrived after midnight. 


‘*Date field’’ specifies which date field in the header to look at for this date range; it probably won’t be 
useful to anyone. If the sequence you’re defining already exists, you can optionally merge the old set with 
the new; that’s what the ‘“Yes’’ and “‘No’’ buttons are all about. Finally, you can ‘‘OK’’ the whole thing, 
or ‘“Cancel’’ it. 


In general, most people will rarely use these features. However, it’s nice to occasionally use ‘‘Pick’’ to 


find some messages, look through them, and then hit ‘‘Delete Sequence’’ to put things back in their origi- 
nal state. 
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As with all standard X applications, xmh may be customized through entries in the resource manager. The 
following resource manager entries are defined: [Note: the entry names must be entered in either all 
lower-case, or in the exact case shown below.] 


BackGround 
ButtonFont 
CheckNewMail 


CompButtonLines 
CompFont 
CompGeometry 
CompLines 
ConfirmFont 
FolderButtonLines 
FolderLines 
ForeGround 


Geometry 
HideBoringHeaders 


InitialFolder 


InitialIncFile 


LabelFont 
MailPath 


MailWaitingFlag 


MhPath 


PickGeometry 
PickEntryFont 
PickTextFont 
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Background color. Currently, this will effect only buttons. (Default is white.) 
What font to use for button names. (Default is timrom10.) 


If True, xmh will check at regular intervals to see if new mail has arrived for any 
of the folders. A visual indication will be given if new mail is waiting to be 
retrieved. (Default is True.) 


How many rows of buttons to display under a composition. (Default is 1.) 
What font to use when composing a message. (Default is 6x13.) 

Initial geometry for windows containing compositions. 

How many lines of a composition to display. (Default is 20.) 

What font to use for confirmation windows. (Default is timrom10b.) 

How many rows of folder command buttons to display. (Default is 1.) 
How many rows of foldername buttons to display. (Default is 1.) 


Foreground color. Currently, this will effect only title bars and buttons. (Default 
is black.) 


Default geometry to use. (Default is none.) 


If on, then Bmh will attempt to skip uninteresting header lines within messages by 
scrolling them off. (Default is on.) 


Which folder to display on startup. May also be set with the command-line option 
-initial. (Default is inbox.) 


The file name of your incoming mail drop. Xmbh tries to construct a filename for 
the ‘‘inc -file’’ command, but in some installations (e.g., those using the Post 
Office Protocol) no file is appropriate. In this case, Initial[ncFile should be 
specified as the empty string, and inc will be invoked without a -file argument. 


What font to use for the title bars. (Default is timrom10i.) 


The full path prefix for locating your mail folders. May also be set with the 
command-line option, -path. (Default is the Path component in 
$HOME]/.mh_profile, or SHOME/Mail if none.) 


If True, xmh will attempt to set an indication in it’s icon when new mail is waiting 
to be retrieved. If this option is True, then CheckNewMail is assumed to be True 
as well. The -flag command line option is a quick way to turn MailWaitingFlag 
on. 


What directory in which to find the mh commands. If a command isn’t found 
here, then the directories in the user’s path are searched. (Default is 


lusr/local/mh6.) 


Initial geometry for pick windows. 
What font to use for user text fields in pick windows. (Default is timrom10.) 
What font to use for static text fields in pick windows. (Default is timrom10.) 
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PrintCommand 


TempDir 


TocButtonLines 
TocFont 
TocGeometry 
TocLines 
TocWidth 


ViewButtonLines 
ViewF ont 
ViewGeometry 
ViewLines 
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What sh command to execute to print a message. Note that stdout and stderr must 
be specifically redirected! If a message or range of messages is selected for print- 
ing, the full file paths of each message file is appended to the specified print com- 
mand. (Default is enscript >/dev/null 2>/dev/null.) 


Directory for xmh to store temporary directories. For privacy, a user might want 
to change this to a private directory. (Default is /tmp.) 


How many rows of message command buttons to display. (Default is 1.) 
What font to use for a folder’s table of contents. (Default is 6x13.) 

Initial geometry for master xmh windows. 

How many messages to display in a folder’s table of contents. (Default is 10.) 


How many characters to generate for each message in a folder’s table of contents. 
(Default is 100. Use 80 if you plan to use mhe a lot.) 


How many rows of buttons to display under a view of a message. (Default is 1.) 
What font to use for a view of a message. (Default is 6x13.) 

Initial geometry for windows showing only a view of a message. 

How many lines of a message to display. (Default is 20.) 


If TocGeometry, ViewGeometry, CompGeometry, or PickGeometry are not specified, then the value of 
Geometry is used instead. If the resulting height is not specified (e.g., “‘’’, ‘‘=500,’’ ‘‘+0-0)’’, then the 
default height is calculated from the fonts and line counts specified above. If the width is not specified 
(e.g., ““’’, “‘=x300,’’ ‘‘-0+0’’), then half of the display width is used. If unspecified, the height of a pick 
window defaults to half the height of the display. 


Any of these options may also be specified on the command line by using the standard X Toolkit resource 
specification mechanism. Thus, to run xmh showing all message headers, 


% xmh -xrm ’*HideBoringHeaders:off’ 


X(1), xrdb(1), X Toolkit, mh(1) - the mh Mail Handler, enscript(1) 


FILES 
“/Mail 
“/.mh_profile 
SEE ALSO 
BUGS 


Printing support is minimal. 


Keyboard shortcuts for commands would be nice.. 


Should handle the “‘unseen’’ message-sequence. 


Should determine by itself if the user hasn’t used mh before, and offer to set things up for him or her. 


Still a few commands missing (rename folder, remail message). 


Needs sub-folder support. 
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NAME 
xmodmap, xprkbd — keyboard modifier utilities for X 

SYNTAX 
xmodmap [-options] [filename] 
xprkbd [-display display] 

DESCRIPTION 
Xmodmap is a utility for displaying and altering the X keyboard modifier map and keysym table on the 
specified display and host. It is intended to be run from a user’s X startup script to setup the keyboard 
according to personal tastes. 


With no arguments, xmodmap displays the current map. 


Xprkbd prints the following on the standard output: a table of the keycodes, the keysym code, and the 
keynames for the keyboard on the appropriate X server. 


OPTIONS 
Both programs accept the following option: 
—display display Specifies the display to use; see X(1). 


The xmodmap program also accepts: 

—help Indicates that a brief description of the command line arguments should be printed 
on the standard error. This will be done whenever an unhandled argument is 
given to xmodmap. 


—grammar Indicates that a help message describing t the expression grammar used in files and 
with -e expressions should be printed on the standard error. 

—verbose Indicates that xmodmap should print logging information as it parses its input. 

—quiet Turns off the verbose logging. This is the default. 

—n Indicates that xmodmap should not change the mappings, but should display what 
it would do, like make(1) does when given this option. 

—e expression Specifies an expression to be executed. Any number of expressions may be 
specified from the command line. 

—p Indicates that the current modifier map should be printed on the standard output. 


- Indicates that the standard input should be used as the input file. 


The filename specifies a file containing xmodmap expressions to be executed. This file is usually kept in 
the user’s home directory with a name like .keymap.km. 


For compatibility with an older version, xmodmap also accepts the following obsolete single letter options: 


-(SLC12345] Indicates that all current keys for the Shift, Lock, Control, or Mod modifier sets 
should be removed from the modifier map. These are equivalent to clear expres- 
sions. 

-[sle] keysym Specifies a keysym to be removed from the Shift, Lock, or Control modifier sets. 


These are equivalent to remove expressions. 


+[slc12345] keysym Specifies a keysym to be added to the Shift, Lock, or Control modifier sets. These 
are equivalent to add expressions. 


EXPRESSION GRAMMAR 
The xmodmap program reads a list of expressions and converts them into appropriate calls to the follow- 
ing Xlib  routines;s XChangeKeyboardMapping(3X), XInsertModifiermapEntry@X), and 
ere ee no Allowable expressions include: 
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keycode NUMBER = KEYSYMNAME ... 
The list of keysyms is assigned to the indicated keycode (which may be specified 
in decimal, hex or octal and can be determined by running the xev program in the 
examples directory). Usually only one keysym is assigned to a given code. 


keysym KEYSYMNAME = KEYSYMNAME ... 
The KEYSYMNAME on the left-hand side is looked up to find its current keycode 
and the line is replaced with the appropriate keycode expression. Note that if you 
have the same keysym bound to multiple keys, this might not work. 


clear MODIFIERNAME 
This removes all entries in the modifier map for the given modifier, where valid 
names are: Shift, Lock, Control, Mod1, Mod2, Mod3, Mod4 and Mod5 (case does 
not matter in modifier names, although it does matter for all other names). For 
example, ‘‘clear Lock’’ will remove all keys that were bound to the shift lock 
modifier. 

add MODIFIERNAME = KEYSYMNAME ... 
This adds the given keysyms to the indicated modifier map. The keysym names 
are evaluated after all input expressions are read to make it easy to write expres- 
sions to swap keys (see the EXAMPLES section below). 


remove MODIFIERNAME = KEYSYMNAME ... 
This removes the given keysyms from the indicated modifier map. Unlike add, 
the keysym names are evaluated as the line is read in. This allows you to remove 
keys from a modifier without having to worry about whether or not they have been 
reassigned. 


Lines that begin with an exclamation mark (! ) are taken as comments. 
If you want to change the binding of a modifier as you must also remove it from the appropriate modifier 
map. 


EXAMPLES 
To make the backspace key generate a delete, use 


% xmodmap -e "keysym BackSpace = Delete” 


To swap the left control and caps lock keys, use: 


! 
! ei Caps_Lock and Control_L 


remove Lock = Caps; Lock 
remove Control = Control_L 
keysym Control_L = Caps_Lock 
keysym Caps_Lock = Control_L 
add Lock = Caps_Lock 

add Control = Control_L 


As a more complicated example of swapping the left control and caps lock keys, you could use: 


! 


! On the HP, the following keycodes have key caps as listed: 
! 


! 101 Backspace 
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! 55 Caps 

! 14 Cri 

! 15 Break/Reset 

! 86 Stop 

! 89 FS 

! 

! Using ‘‘keycode’’ over ‘‘keysym’’ you can rerun the file to 
! fix up your keyboard. 

! 


! This sets the backspace key to generate Delete, flushes all caps lock 
! bindings, assigns a control key to what used to be the caps lock key, 
! makes the F1 generate ESC, and assigns 

! the Break/Reset key to be a shift lock. 


keycode 101 = Delete 
keycode 55 = Control_R 
clear Lock 

add Control = Control_R 
keycode 89 = Escape 
keycode 15 = Caps_Lock 
add Lock = Caps_Lock 


ENVIRONMENT 


DISPLAY To get default host and display number. 


SEE ALSO 


BUGS 


X(1), xprkbd(1), make(1), XChangeKeyboardMapping(3X), XInsertModifiermapEntry(3X), 
XDeleteModifiermapEntry (3X) . 


Every time a keycode expression is evaluated, the server generates a MappingNotify event on every 
client. This can cause some thrashing. All of the changes should be batched together and done at once. 
Clients that receive keyboard input and ignore MappingNotify events will not notice any changes made to 
keyboard mappings. 


Xmodmap should generate add and remove expressions automatically whenever a keycode that is already 
bound to a modifier is changed. 


There should be a way to have the remove expression accept keycodes as well as keysyms for those times 
when you really mess up your mappings. 
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NAME 
xpr ~ print an X window dump 


SYNTAX 
xpr [-scale scale] [-height inches] [-width inches] [-left inches] [-top inches] [-header string] [-trailer 
string] [-landscape] [-portrait] [-rv] [-compact] [-output filename] [-append filename] [-noff] [-split n] [- 
device dev] [filename] _ 


DESCRIPTION 
Xpr takes as input a window dump file produced by xwd(1) and formats it for output on the LN0O3, LA100, 
PostScript printers, or IBM PP3812 page printer. If no file argument is given, the standard input is used. 
By default, xpr prints the largest possible representation of the window on the output page. Options allow 
you to add headers and trailers, specify margins, adjust the scale and orientation, and append multiple win- 
dow dumps to a single output file. Output is to standard output unless —output is specified. 


OPTIONS 

~—scale scale Affects the size of the window on the page. The LNO3 and PostScript printers are 
able to translate each bit in a window pixel map into a grid of a specified size. For 
example, each bit might translate into a 3x3 grid. This would be specified by 
~scale 3. By default a window is printed with the largest scale that will fit onto 
the page for the specified orientation. 

—height inches Specifies the maximum height of the window on the page. 

—width inches Specifies the maximum width of the window. 

—left inches Specifies the left margin in inches. Fractions are allowed. By default the window 
is centered in the page. 

—top inches Specifies the top margin for the picture in inches. Fractions are allowed. 

—header header Specifies a header string to be printed above the window. 

—trailer trailer Specifies a trailer string to be printed below the window. 

—landscape Forces the window to be printed in landscape mode. By default a window is 
printed such that its longest side follows the long side of the paper. 

—portrait Forces the window to be printed in portrait mode. By default a window is printed 
such that its longest side follows the long side of the paper. 

—TI'V Forces the window to be printed in reverse video. 

—compact Uses simple run-length encoding for compact representation of windows with lots 
of white pixels. 

—output filename Specifies an output file name. If this option is not specified, standard output is 
used. . 

—append filename Specifies a filename previously produced by xpr to which the window is to be 
appended. | 

~—noff When specified in conjunction with —append, the window appears on the same 
page as the previous window. a 

—split n Allows you to split a window onto several pages. This might be necessary for very 
large windows that would otherwise cause the printer to overload and print the 
page in an obscure manner. . 

—device device . Specifies the device on which the file will be printed. Currently only the LNO3 (- 


device In03), LA100 (-device 1a100), PostScript printers (-device ps), and IBM 
PP3812 (-device pp) are supported. -device Iw (LaserWriter) is equivalent to 
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-device ps and is provided only for backwards compatibility. 


- SEE ALSO 


xwd(1), xdpr(1), xwud(1), X(1) 


LIMITATIONS | 
The current version of xpr can generally print outon the LNO3 most X windows that are not larger than 
two-thirds of the screen. For example, it will be able to print out a large Emacs window, but it will usu- 
ally fail when trying to print out the entire screen. The LNO3 has memory limitations that can cause it to 
incorrectly print very large or complex windows. The two mostcommon errors encountered are 
‘“‘band too complex’ and ‘‘page memory exceeded.’’ In the first case, a window may have a particular 
six pixel row that contains too many changes (from black to white to black). This will cause the printer 
to drop part of the line and possibly parts of the rest of the page. The printer will flash the number ‘1’ on 
its front panel when this problem occurs. A possible solution to this problem is to increase the scale of the 
picture, or to split the picture onto two or more pages. The second problem, ‘‘page memory 
exceeded,’’ will occur if the picture contains too much black, or if the picture contains complex half- 
tones such. as_the background color of a display. When this problem occurs the printer will automat- 
ically split the picture into two or more pages. It may flash the number ‘5’ on its from panel. There is 
no easy solution to this problem. It will probably be necessary to either cut and paste or rework the 
application to produce a less complex picture. 


Xpr provides some support for the LA100. However, there are several limitations on its use: The pic- 
ture will always be printed in portrait mode, there is no scaling, and the aspect ratio will be slightly off. 


Support for PostScript output currently cannot handle the -append, -noff, or -split options. 


The -compact option is only supported for PostScript output. It compresses white space but not black 
space, so it is not useful for reverse-video windows. 
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NAME 
xmodmap, xprkbd — keyboard modifier utilities for X 


SYNTAX 
xmodmap [-options] [filename] 


xprkbd [-display display] 


DESCRIPTION 
Xmodmap is a utility for displaying and altering the X keyboard modifier map and keysym table on the 
specified display and host. It is intended to be run from a user’s X startup script to setup the keyboard 
according to personal tastes. 


With no arguments, xmodmap displays the current map. 


Xprkbd prints on the standard output a table of the keycodes, the keysym code, and the keynames for the 
keyboard on the appropriate X server. 


OPTIONS 
Both programs accept the following option: 
—display display Specifies the display to use; see X(1). 


The xmodmap program also accepts: 


—help Indicates that a brief description of the command line arguments should be printed 
on the standard error. This will be done whenever an unhandled argument is 
given to xmodmap. 


—grammar Indicates that a help message describing the expression grammar used in files and 
with -e expressions should be printed on the standard error. 

—verbose Indicates that xmodmap should print logging information as it parses its input. 

~—quiet Turns off the verbose logging. This is the default. 

—n Indicates that xmodmap should not change the mappings, but should display what 
it would do, like make(1) does when given this option. 

—e expression - Specifies an expression to be executed. Any number of expressions may be 
specified from the command line. 

—p Indicates that the current modifier map should be printed on the standard output. 


_ A lone dash means that the standard input should be used as the input file. 


The filename specifies a file containing xmodmap expressions to be executed. This file is usually kept in 
the user’s home directory with a name like. .keymap.km. 


For compatibility with an older version, xmodmap also accepts the following obsolete single letter options: 


-(SLC12345] Indicates that all current keys for the Shift, Lock, Control, or Mod modifier sets 
should be removed from the modifier map. These are equivalent to clear expres- 
sions. 

-[slc] keysym Specifies a keysym to be removed from the Shift, Lock, or Control moder sets. 


These are equivalent to remove expressions. 


+[slc12345] keysym Specifies a keysym to be added to the Shift, Lock, or Control modifier sets. These 
. ; are equivalent to add expressions. 


EXPRESSION GRAMMAR 
The xmodmap program reads a list of expressions and converts them into appropriate calls to the follow- 
ing Xlib routines: XChangeKeyboardMapping(3X), XInsertModifiermapEntry(3X) and 
XDeleteModifiermapEntry(3X). Allowable expressions include: 
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keycode NUMBER = KEYSYMNAME ... 
The list of keysyms is assigned to the indicated keycode (which may be specified in decimal, hex 
or octal and can be determined by running the xev program in the examples directory). Usually 
only one keysym is assigned to a given code. 


keysym KEYSYMNAME = KEYSYMNAME ... 
The KEYSYMNAME on the left hand side is looked up to find its current keycode and the line is 
replaced with the appropriate keycode expression. Note that if you have the same keysym bound 
to multiple keys, this might not work. 

clear MODIFIERNAME 
This removes all entries in the modifier map for the given modifier, where valid name are: Shift, 
Lock, Control, Mod1, Mod2, Mod3, Mod4 and ModS (case does not matter in modifier names, 
although it does matter for all other names). For example, ‘‘clear Lock’’ will remove all any 
keys that were bound to the shift lock modifier. 

add MODIFIERNAME = KEYSYMNAME ... 
This adds the given keysyms to the indicated modifier map. The keysym names are evaluated 
after all input expressions are read to make it easy to write expressions to swap keys (see the 
EXAMPLES section). . 

remove MODIFIERNAME = KEYSYMNAME ... 
This removes the given keysyms from the indicated modifier map. Unlike add, the keysym 
names are evaluated as the line is read in. This allows you to remove keys from a modifier 
without having to worry about whether or not they have been reassigned. 


Lines that begin with an exclamation mark (! ) are taken as comments. 


If you want to change the binding of a modifier key, you must also remove it from the appropriate modifier 
map. 


EXAMPLES 
To make the backspace key generate a delete instead, use 


% xmodmap -e "keysym BackSpace = Delete” 


To swap the left control and caps lock keys you could use: 


! 
! Swap Caps_Lock and Control_L 
! 


remove Lock = Caps_Lock 
remove Control = Control_L 

~ keysym Control_L = Caps_Lock 
keysym Caps_Lock = Control_L 
add Lock = Caps_Lock 
add Control = Control_L 


As a more complicated example, the following is what the author uses: 


! 
! On the HP, the following keycodes have key caps as listed: 
f . 


! 101 Backspace 
! 55 Caps 
! 


1 September 1988 INTEGRATED SOLUTIONS ”) 


XPRKBD (1) X Window System Reference Manual - XPRKBD (1) 
15 Break/Reset 


! I prefer using ‘‘keycode’’ over ‘‘keysym’’ so that I can rerun the file to 
! fix up my keyboard. 
! 


! This sets the backspace key to generate Delete, flushes all caps lock 
! bindings, assigned a control key to what used to be the caps lock key, 
! makes the F1 generate ESC, and makes the Break/Reset key be a shift lock. 


keycode 101 = Delete 
keycode 55 = Control_R 
clear Lock 

add Control = Control_R 
keycode 89 = Escape 
keycode 15 = Caps_Lock 
add Lock = Caps_Lock 


ENVIRONMENT 
DISPLAY 
to get default host and display number. 
SEE ALSO 
X(1), make(1), xmodmap(1), XChangeKeyboardMapping(3X), XInsertModifiermapEntry(3X), 
XDeleteModifiermapEntry(3X) . 
BUGS 


Every time a keycode expression is evaluated, the server generates a MappingNotify event on every 
client. This can cause some thrashing. All of the changes should be batched together and done at once. 
Clients that receive keyboard input and ignore MappingNotify events will not notice any changes made to 
keyboard mappings. 


Xmodmap should generate add and remove expressions automatically whenever a keycode that is already 
bound to a modifier is changed. 


There should be a way to have the remove expression accept keycodes as well as keysyms for those times 
when you really mess up your mappings. 
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NAME 
xprop — property displayer for X 


SYNTAX 
xprop [-help] [-grammar] [-id id] [-root] [-name name] [-font font] [-display display] [-len n] [-notype] [-fs 
file) [-£ atom format (dformat)]* [format (dformat} atom]* 


SUMMARY 
The xprop utility is for displaying window and font properties in an X server. One window or font is 
selected using the command line arguments, or possibly, in the case of a window, by clicking on the 
desired window. A list of properties is then given, possibly with formatting information. 


OPTIONS 

-help Prints out a summary of command line options. 

-grammar Prints out a detailed grammar for all command line options. 

-id id Allows you to select window id on the command line rather than using the 
pointer to select the target window. This is very useful in debugging X applica- 
tions where the target window is not mapped to the screen or where the use of 
the pointer might be impossible or interfere with the application. 

-hame name Allows you to specify that the window named name is the target window on the 
command line rather than using the pointer to select the target window. 

-font font Allows you to specify that the properties of font font should be displayed. 

-root Specifies that X’s root window is the target window. This is useful in situations 

. where the root window is completely obscured. 

-display display Allows you to specify the server to connect to (see X(1)). 

-len n Specifies that at most n bytes of any property should be read or displayed. 

-notype Specifies that the type of each property should not be displayed. 

-fs file Specifies that file file should be used as a source of more formats for properties. 

-f name format (dformat] 

Specifies that the format for name should be format and that the dformat for name 
should be dformat. If dformat is missing, ‘* = $0-+\n’’ is assumed. 
DESCRIPTION 


For each of these properties, its value on the selected window or font is printed using the supplied format- 
ting information if any. If no formatting information is supplied, internal defaults are used. If a property is 
not defined on the selected window or font, ‘‘not defined’’ is printed as the value for that property. If no 
property list is given, all the properties possessed by the selected window or font are printed. 


A window may be selected in one of four ways. First, if the desired window is the root window, the -root 
argument may be used. If the desired window is not the root window, it may be selected in two ways on 
the command line, either by id number such as might be obtained from xwininfo, or by name if the window 
possesses a name. The -id argument selects a window by id number in either decimal or hex (must start 

with Ox) while the -name argument selects a window by name. 


The last way to select a window does not involve the command line at all. If none of -font, -id, -name, and 
-root are specified, a crosshairs cursor is displayed and you are allowed to choose any visible window by 
pressing any pointer button in the desired window. If it is desired to display properties of a font as opposed 
to a window, the -font argument may be used. 


Other than the above four arguments, the -help argument for obtaining help, and the -grammar argument 
for listing the full grammar for the command line, all other command line arguments are used in specifying 
both the format of the properties to be displayed and how to display them. The -len n argument specifies 
that at most n bytes of any given property will be read and displayed. This is useful for example when 
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displaying the cut buffer on the root window which could run to several pages if displayed in full. 


Normally each property name is displayed by printing first the property name, then its type (if it has one) in 
parentheses, followed by its value. The -notype argument specifies that property types should not be 
displayed. The -fs argument is used to specify a file containing a list of formats for properties while the -f 
argument is used to specify the format for one property. 


The formatting information for a property actually consists of two parts, a yams and a dformat. The for- 
mat specifies the actual formatting of the property (i.e., is it made up of words, bytes, or longs?, etc.), while 
the dformat specifies how the property should be displayed. 


The following paragraphs describe how to construct formats and dformats. However, for the vast majority 
of users and uses, this should not be necessary as the built in defaults contain the formats and dformats 
necessary to display all the standard properties. It should only be necessary to specify formats and dfor- 
mats if a new property is being dealt with or you dislike the standard display format. New users are 
encouraged to skip this part. 


A format consists of one of 0, 8, 16, or 32 followed by a sequence of one or more format characters. The 
0, 8, 16, or 32 specifies how many bits per field there are in the property. Zero is a special case meaning 
use the field size information associated with the property itself. (This is only needed for special cases like 
type INTEGER, which is actually three different types depending on the size of the fields of the property.) 


A value of 8 means that the property is a sequence of bytes while a value of 16 would mean that the pro- 
perty is a sequence of words. The difference between these two lies in the fact that the sequence of words 
will be byte-swapped while the sequence of bytes will not be when read by a machine of the opposite byte 
order of the machine that orginally wrote the property. For more information on how properties are format- 
ted and stored, consult the Xlib manual. 


Once the size of the fields has been specified, it is necessary to specify the type of each field (i.e., is it an 
integer, a string, an atom?) This is done using one format character per field. If there are more fields in the 
property than format characters supplied, the last character will be repeated as many times as necessary for 
the extra fields. The format characters and their meaning are as follows: 


a The field holds an atom number. A field of this type should be of size 32. 

b The field is a boolean. A 0 means false while anything else means true. 

Cc The field is an unsigned number, a cardinal. 

i The field is a signed integer. 

m The field is a set of bit flags, 1 meaning on. 

s This field and the next ones until either a 0 or the end of the property represent a sequence of 
bytes. This format character is only usable with a field size of 8 and is most often used to 
represent a string. 

x The field is a hex number (like ‘‘c,’’ but displayed in hex - most useful for displaying window ids 
and the like). 


An example format is 32ica which is the format for a property of three fields of 32 bits each, the first hold- 
ing a signed integer, the second an unsigned integer, and the third an atom. 


The format of a dformat unlike that of a format is not so rigid. The only limitations on a dformat is that one 
may not start with a letter or a dash. This is so that it can be distinguished from a property name or an 
argument. A dformat is a text string containing special characters instructing that various fields be printed 
at various points in a manor similar to the formatting string used by printf. For example, the dformat ‘‘ is ( 
$0, $1 \)\\n”’ would render the POINT 3, -4 which has a format of 32ii as ‘* is (3, 4 )\n.”’ 


Any character other than a $, ?, \, or a ( in a dformat prints as itself. To print out $, ?, \, or ( preceed it by a 
\(.e., to print out a $, use \$). Several special backslash sequences are provided as shortcuts. \n will cause 
a newline to be displayed while \t will cause a tab to be displayed. \o will display character number o 
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where o is an octal number. 


A $ followed by a number n causes field number n to be displayed. The format of the displayed field 
depends on the formatting character used to describe it in the corrsponding format (i.e., if a cardinal is 
described by “‘c,’’ it will print in decimal while if it is described by a ‘‘x’’ it is displayed in hex). 

If the field is not present in the property (this is possible with some properties), <field not available> is 
displayed instead. $n+ will display field number n, then a comma, then field number +1, then another 
comma, then ... until the last field is defined. If field n is not defined, nothing is displayed. This is useful 
for a property that is a list of values. 
A ? is used to start a conditional expression, a kind of if-then statement. ?exp(text) will display text if and 
only if exp evaluates to non-zero. This is useful for two things. First, it allows fields to be displayed if and 
only if a flag is set. And second, it allows a value, such as a state number, to be displayed as a name rather 
than as just anumber. The syntax of exp is as follows: 


exp st= term | term=exp | !exp 

term ::=n|$nimn 

The ! operator is a logical ‘‘not,’’ changing 0 to 1 and any non-zero value to 0. = is an equality operator. 
Note that internally all expressions are evaluated as 32 bit numbers so -1 is not equal to 65535. = returns 1 
if the two values are equal and 0 if not. n represents the constant value n while $n represents the value of 


field number n. (maz is 1 if flag number n in the first field having format character ‘‘m’’ in the corrsponding 
format is 1, 0 otherwise.) 


Examples: ?m3(count: $3\n) displays field 3 with a label of count if and only if flag number 3 (count starts 
at 0!) is on. ?$2=0(True)?!$2=0(False) displays the inverted value of field 2 as a boolean. 


In order to display a property, xprop needs both a format and a dformat. Before xprop uses its default 
values of a format of 32x and a dformat of ‘‘ = { $0+ }Nn,”’ it searches several places in an attempt to find 
more specific formats. First, a search is made using the name of the property. If this fails, a search is made 
using the type of the property. This allows type STRING to be defined with one set of formats while 
allowing property WM_NAME which is of type STRING to be defined with a different format. In this 
way, the display formats for a given type can be overridden for specific properties. 


The locations searched are in order: the format if any specified with the property name (as in 8x 
WM_NAME), the formats defined by -f options in last to first order, the contents of the file specified by the 
-fs option if any, the contents of the file specified by the environmental variable XPROPFORMATS if any, 
and finally xprop’s built in file of formats. 


The format of the files refered to by the -fs argument and the XPROPFORMATS variable is one or more 
lines of the following form: 


name format (dformat] 


Where name is either the name of a property or the name of a type, format is the format to be used with 
name and dformat is the dformat to be used with name. If dformat is not present, ‘‘ = $0+\n’’ is assumed. 


EXAMPLES 
To display the name of the root window: xprop -root WM_NAME. 


To display the window manager hints for the clock: xprop -name xclock WM_HINTS. 
To display the start of the cut buffer: xprop -root -len 100 CUT_BUFFERO. 

To display the point size of the fixed font: xprop -font fixed POINT_SIZE. 

To display all the properties of window # 0x200007: xprop -id 0x200007. 


1 September 1988 INTEGRATED SOLUTIONS 3 


XPROP (1) X Window System Reference Manual XPROP (1) 


ENVIRONMENT 

DISPLAY _ To get default display. 

XPROPFORMATS _ Specifies the name of a file from which additional formats are to be obtained. 
SEE ALSO 


X(1), xwininfo(1) Xlib manual (on-line version) 
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NAME 


xrdb — X server resource database utility 


SYNTAX 


xrdb [-option] [filename] 


DESCRIPTION 


Xrdb is used to get or set the contents of the RESOURCE_MANAGER property on the root window of 
screen 0. You would normally run this program from your X startup file. 


The resource manager (used by the Xlib routine XGetDefault(3X) and the X Toolkit) uses the 
RESOURCE_MANAGER property to get user preferences about color, fonts, and so on for applications. 
Having this information in the server (where it is available to all clients) instead of on disk, solves the prob- 
lem in previous versions of X that required you to maintain defaults files on every machine that you might 
use. It also allows for dynamic changing of defaults without editing files. 


For compatibility, if there is no RESOURCE_MANAGER property defined (either because xrdb was not 
run or if the property was removed), the resource manager will look for a file called Xdefaults in your 
home directory. 

The filename (or the standard input if ‘‘-’’ or no input file is given) is optionally passed through the C 
preprocessor with the following symbols defined, based on the capabilities of the server being used: 


HOST=hostname The hostname portion of the display to which you are connected. 
WIDTH=num The width of the screen in pixels. 
HEIGHT=num The height of the screen in pixels. 


X_RESOLUTION=num The x resolution of the screen in pixels per meter. 
Y_RESOLUTION=num The y resolution of the screen in pixels per meter. 


PLANES=num The number of bit planes for the default visual. 

CLASS=visualclass One of StaticGray, GrayScale, StaticColor, PsuedoColor, TrueColor, 
DirectColor. 

COLOR Only defined if the default visual’s type is one of the color options. 

Lines that begin with an exclamation mark (! ) are ignored and may be used as comments. 

OPTIONS 

—help Causes a brief description of the allowable options and parameters to be 
printed. 

—display display Specifies the X server to be used; see X(1). 

—cpp filename Specifies the pathname of the C preprocessor program to be used. Although 

. xrdb was designed to use CPP, any program that acts as a filter and accepts 

the —D, —I, and —U options may be used. 

—nocpp Indicates that xrdb should not run the input file through a preprocessor 
before loading it into the RESOURCE_MANAGER property. 

~symbols Indicates that the symbols that are defined for the preprocessor should be 
printed onto the standard output. It can be-used in conjunction with —query, 
but not with the options that change the RESOURCE_MANAGER pro- 
perty. 

—query Indicates that the current contents of the RESOURCE_MANAGER pro- 


perty should be printed onto the standard output. Note that since preproces- 
sor commands in the input resource file are part of the input file, not part of 
the property, they won’t appear in the output from this option. The —edit 
option can be used to merge the contents of the property back into the input 
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—load 


—merge 


—remove 


—edit filename 


—backup string 
—Dname[=value] 
—Uname 
—Idirectory 
FILES 
Generalizes ‘/ Xdefaults files. 
SEE ALSO 
ENVIRONMENT 


DISPLAY 
BUGS 
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resource file without damaging preprocessor commands. 


Indicates that the input should be loaded as the new value of the 
RESOURCE_MANAGER property, replacing whatever was there (i.e., the 
old contents are removed). This is the default action. 


Indicates that the input should be merged with, instead of replacing, the 
current contents of the RESOURCE_MANAGER property. Since xrdb can 
read the standard input, this option can be used to change the contents of the 
RESOURCE_MANAGER property directly from a terminal or from a shell 
script. 

Indicates that the RESOURCE_MANAGER property should be removed 
from its window. 


Indicates that the contents of the RESOURCE_MANAGER property should 
be edited into the given file, replacing any values already listed there. This 
allows you to put changes that you have made to your defaults back into 
your resource file, preserving any comments or preprocessor lines. 


Specifies a suffix to be appended to the filename used with —edit to generate 
a backup file. 


Passes through to the preprocessor and is used to define symbols for use 
with conditionals such as #ifdef. 


Passes through to the preprocessor and is used to remove any definitions of 
this symbol. 


Passes through to the preprocessor and is used to specify a directory to 
search for files that are referenced with #include. 


X(1), XGetDefault(3X), Xlib Resource Manager documentation 


To figure out which display to use. 


The default for no arguments should be to query, not to overwrite, so that it is consistent with other pro- 


grams, 


1 September 1988 


INTEGRATED SOLUTIONS yi) 


XREFRESH (1) X Window System Reference Manual XREFRESH (1) 


NAME 

xrefresh — refresh all or part of an X screen 
SYNTAX 

xrefresh [-option] 
DESCRIPTION 


Xrefresh is a simple X program that causes all or part of your screen to be repainted. Xrefresh maps a 
window on top of the desired area of the screen and then immediately unmaps it, causing refresh events to 
be sent to all applications. By default, a window with no background is used, causing all applications to 
repaint ‘‘smoothly.’’ However, the various options can be used to indicate that a solid background (of any 
color) or the root window background should be used instead. 


OPTIONS 

-white Specifies a white background. The screen just appears to flash quickly, and 
then repaint. 

—black Specifies a black background (in effect, turning off all of the electron guns 
to the tube). This can be somewhat disorienting as everything goes black 
for a moment. 

—solid color Specifies a solid color background. Try green. 

—root Specifies the root window background. 

—none Repaints all of the windows. (This is the default.) 

—geometry WxH+X+Y Specifies the portion of the screen to be repainted. This superceeds the old 

style =WxH+X+Y. 

—display display Allows you to specify the server and screen to refresh; see X(1). 

X DEFAULTS 

The xrefresh program uses the routine XGetDefault(3X) to read defaults, so its resource names are all 

capitalized. . 

Black, White, Solid, None, Root Determines what sort of window background to use. 

Geometry Determines the area to refresh. Not very useful. 

ENVIRONMENT 
DISPLAY To get default host and display number. 
SEE ALSO 


X(1), XGetDefault(3X) 
BUGS 
It should have just one default type for the background. 
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NAME 
xset — user preference utility for X 


SYNTAX 
xset [-display display] [-b] [b on/off] [b [volume [pitch [duration]]] [-c] [c on/off] [c [volume]] [fp 
path{,path{,...]]] [fp default] [[-]led [integer]] [led on/off] [m[ouse] [acceleration [threshold]]] [m[ouse] 
default] [p pixel color] [[-]r] [r on/off] [s [length [period]]] {s blank/noblank] [s expose/noexpose] [s 
on/off] [s default] [q] 


DESCRIPTION 
This program sets various user preference options of the display. 


OPTIONS 
—display display Specifies which server to use; see X(1). 


b Controls the bell volume, pitch, and duration. This option accepts up to three 
numerical parameters, a preceding dash ( - ), or an ‘‘on/off’’ flag. If no parame- 
ters are given, or the ‘‘on’’ flag is used, the system defaults will be used. If the 
dash or ‘‘off’’ are given, the bell will be turned off. If only one numerical param- 
eter is given, the bell volume will be set to that value, as a percentage of its max- 
imum. Likewise, the second numerical parameter specifies the bell pitch in hertz, 
and the third numerical parameter specifies the duration in milliseconds. Note that 
not all hardware can vary the bell characteristics. The X server will set the 
characteristics of the bell as closely as it can to the user’s specifications. 


Cc Controls the key click. Takes an optional value, a preceding dash ( - ), or an 
‘‘on/off’’ flag. If no parameter or the ‘‘on’’ flag is given, the system defaults are 
used. If the dash or “‘off’’ flag is used, keyclick is disabled. If a value from 0 to 
100 is given, it is used to indicate volume, as a percentage of the maximum. The 
X server sets the volume to the nearest value that the hardware can support. 


fp Sets the font path. It must be followed by a comma-separated list of directories or 
. the flag ‘‘default.’’ The indicated path is used to find fonts for clients. To restore 
the default font path, use fp default. ° 


led Controls the keyboard LEDs. This controls the turning on or off of one or all of 
the LEDs. It accepts an optional integer, a preceding dash ( - ), or an ‘‘on/off’’ 
flag. If no parameter or the ‘‘on’’ flag is given, all LEDs are turned on. If a 
preceding dash or the flag ‘‘off’’ is given, all LEDs are turned off. If a value 
between 1 and 32 is given, that LED is turned on or off depending on the 
existence of a preceding dash. A common LED which can be controlled is the 
**Caps Lock’’ LED. ‘‘xset led 3’’ would turn led #3 on. ‘‘xset -led 3’’ would 
turn it off. The particular LED values may refer to different LEDs on different 
hardware. 


m . Controls the mouse parameters. The parameters for the mouse are ‘‘acceleration’’ 
and ‘‘threshold.’’ The mouse, or whatever pointer the machine is connected to, 
will go ‘“‘acceleration’’ times as fast when it travels more than ‘‘threshold’’ pixels 
in a short time. This way, the mouse can be used for precise alignment when it is 
moved slowly, yet it can be set to travel across the screen in a flick of the wrist 
when desired. One or both parameters for the m option can be omitted, but if only 
one is given, it is interpreted as the acceleration. If no parameters or the flag 
‘‘default’’ is used, the system defaults will be set. . 


p Controls the pixel color values. The parameters are the colormap entry number in 
decimal, and a color specification. The root background colors may be changed 
on some servers by altering the entries for BlackPixel and WhitePixel. Although 
these are often 0 and 1, they need not be. Also, a server may choose to allocate 
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those colors privately, in which case an error will be generated. The map entry 
must not be a read-only color or an error will result. 


Controls the autorepeat. If a preceding dash or the ‘‘off’’ flag is used, autorepeat 
is disabled. If no parameters or the ‘‘on’’ flag is used, autorepeat is enabled. 


Allows you to set the screen saver parameters. This option accepts up to two 
numerical parameters, a ‘‘blank/noblank’’ flag, an ‘‘expose/noexpose’’ flag, an 
“‘on/off’’ flag, or the “‘default’’ flag. If no parameters or the “‘default’’ flag is 
used, the system is set to its default screen saver characteristics. The ‘‘on/off’’ 
flags simply turn the screen saver functions on or off. The ‘“‘blank’’ flag sets the 
preference to blank the video (if the hardware can do so) rather than display a 
background pattern, while ‘‘noblank’’ sets the preference to display a pattern 
rather than blank the video. The ‘“‘expose’’ flag sets the preference to allow win- 
dow exposures (the server can freely discard window contents), while “‘noex- 
pose’’ sets the preference to disable screen saver unless the server can regenerate 
the screens without causing exposure events. The length and period parameters 
for the screen saver function determines how long the server must be inactive for 
screen saving to activate, and the period to change the background pattern to avoid 
burn in. The arguments are specified in seconds. If only one numerical parameter 
is given, it is used for the length. 


Provides you information on the current settings. 


These settings are reset to default values when you log out. 
Note that not all X implementations are guaranteed to honor all of these options. 


SEE ALSO 


X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1) 
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xsetroot — root window parameter setting utility for X 


SYNTAX 


xsetroot [-help] [-def] [-display display] [-cursor cursorfile maskfile] [-bitmap filename] [-mod x y] [-gray] 
[-grey] [-fg color] [-bg color] [-rv] [-solid color] [-name string] 


DESCRIPTION 


The xsetroot program allows you to tailor the appearance of the background (‘‘root’’) window on a works- 
tation display running X. Normally, you experiment with xsetroot until you find a personalized look that 
you like, then put the xsetroot command that produces it into your X startup file. If no options are 
specified, or if -def is specified, the window is reset to its default state. The -def option can be specified 
along with other options and only the non-specified characteristics will be reset to the default state. 


Only one of the background color/tiling changing options ( -solid, -gray, -grey, -bitmap, and -mod ) may 


be specified at a time. 


OPTIONS 
-help 


-def 


-cursor cursorfile maskfile 


-bitmap filename 


-mod x y 


“gray 
“grey 
-fg color 
-bg color 


“I'v 


-solid color 


“name string 


-display display 
SEE ALSO 


Prints a usage message and exits. 


Resets unspecified attributes to their default values. (Restores the background 
to the familiar gray mesh and the cursor to the hollow x shape.) 


Changes the cursor to whatever you want when the cursor is outside of any 
window. Cursor and mask files are bitmaps (little pictures), and can be made 
with the bitmap(1) program. You probably want the mask file to be all black 
until you get used to the way masks work. 


Uses the bitmap specified in the file to set the window pattern. You can make 
your own bitmap files (little pictures) using the bitmap(1) program. The 
entire background will be made up of repeated ‘‘tiles’’ of the bitmap. 


Creates a plaid-like grid pattern on your screen. x and y are integers ranging 
from 1 to 16. Try the different combinations. Zero and negative numbers are 
taken as 1. 


Makes the entire background gray. (Easier on the eyes.) 

Makes the entire background grey. | 

Uses color as the foreground color when setting attributes. 

Uses color as the background color when setting attributes. 

Exchanges the foreground and background colors. Normally the foreground 


_ color is black and the background color is white. 


Sets the window color to color. 


Sets the name of the root window to string. There is no default value. Usually 
a name is assigned to a window so that the window manager can use a text 
representation when the window is iconified. This option is unused since you 
can’t iconify the background. . 


Specifies the server to connect to; see X(1). 


X(1), xset(1), xrdb(1), bitmap(1) 
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NAME 


xterm — terminal emulator for X 


SYNTAX 


xterm [-toolkitoption] [-option] 


DESCRIPTION 


The xterm program is a terminal emulator for the X Window System. It provides DEC VT102 and Tek- 
tronix 4014 compatible terminals for programs that can’t use the window system directly. If the underlying 
operating system supports terminal resizing capabilities (for example, the SIGWINCH signal in systems 
derived from 4.3BSD), xterm uses the facilities to notify programs running in the window whenever it is 
resized. 


The VT102 and Tektronix 4014 terminals each have their own window so that you can edit text in one and 
look at graphics in the other at the same time. To maintain the correct aspect ratio (height/width), Tek- 
tronix graphics are restricted to the largest box with a 4014’s aspect ratio that fits in the window. This box 
is located in the upper left area of the window. 


Although both windows may be displayed at the same time, one of them is considered the active window 
for receiving keyboard input and terminal output. This is the window that contains the text cursor and 
whose border highlights whenever the pointer is in either window. The active window can be chosen 
through escape sequences, the Modes menu in the VT102 window, and the Tektronix menu in the 4014 
window. 


OPTIONS 


The xterm terminal emulator accepts all of the standard X Toolkit command line options along with the 
additional options listed below (if the option begins with a “‘+’’ instead of a “‘—’’, the option is restored to 
its default value): 


—132 Causes the DECCOLM escape sequence to be recognized, and the xterm win- 
dow will resize appropriately. Normally, the VT102 DECCOLM escape 
sequence that switches between 80 and 132 column mode is ignored. 


—b number Specifies the size of the inner border (the distance between the outer edge of 
the characters and the window border) in pixels. The default is 2. 


—cr color Specifies the color to use for text cursor. The default is to use the same fore- 
ground color that is used for text. 


—cu Indicates that xterm should work around a bug in the curses(3X) cursor 
motion package that causes the more(1) program to display lines that are 
exactly the width of the window and are followed by a line beginning with a 
tab to be displayed incorrectly (the leading tabs are not displayed). 


+cu Indicates that xterm should not work around the curses(3X) bug mentioned 
above. 


—e program [arguments] Specifies the program (and its command line arguments) to be run in the 
xterm window. The default is to start the user’s shell. This must be the last 
option on the command line. 


—fb font Specifies a font to be used when displaying bold text. This font must be the 
same height and width as the normal font. If only one of the normal or bold 
fonts is specified, it will be used as the normal font and the bold font will be 
produced by overstriking this font. The default bold font is vtbold. 


-j Indicates that xterm should do jump scrolling. Normally, text is scrolled one 
line at a time; this option allows xterm to move multiple lines at a time so that 
it doesn’t fall as far behind. Its use is strongly recommended since it makes 
xterm run much faster when scanning through large amounts of text. The 
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- 


+l 


—If filename 


~Is 


+Is 


+mb 


—ms color 


—nb number 


+rw. 
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VT100 escape sequences for enabling and disabling smooth scroll as well as 
the Modes menu can be used to turn this feature on or off. 


Indicates that xterm should not do jump scrolling. 


Indicates that xterm should send all terminal output to a log file as well as to 
the screen. This option can be enabled or disabled using the xterm X11 menu. 


Indicates that xterm should not do logging. 


Specifies the name of the file to which the output log described above is writ- 
ten. If file begins with a pipe symbol (| ), the rest of the string is assumed to 
be a command to be used as the endpoint of a pipe. The default filename is 
XtermLog.XXXXX (where XXXXX is the process id of xterm) and is created 
in the directory from which xterm was started (or the user’s home directory in 
the case of a login window). 

Indicates that the shell started in the xterm window is to be a login shell (i.e., 
the first character of argv[0] will be a dash, indicating to the shell that it should 
read the user’s ./ogin or .profile). 
Indicates that the shell started should not be a login shell (i.e., it will be normal 
subshell). 

Indicates that xterm should ring a margin bell when the user types near the 
right end of a line. This option can be turned on and off from the Modes 
menu. 


Indicates that the margin bell should not be rung. 


Specifies the color to be used for the cursor. The default is to use the fore- 
ground color. 


Specifies the number of characters from the right end of a line at which the 
margin bell, if enabled, will ring. The default is 10. 


Indicates that reverse-wraparound should be allowed. This allows the cursor 
to back up from the leftmost column of one line to the rightmost column of the 
previous line. This is very useful for editing long shell command lines and is 
encouraged. This option can be turned on and off from the Modes menu. 


Indicates that reverse-wraparound should not be allowed. 


Indicates that xterm may scroll asynchronously, meaning that the screen does 
not have to be kept completely up to date while scrolling. This allows xterm 
to run faster when network latencies are very high and is typically useful when 
running across a very large internet or many gateways. 


Indicates that xterm should scroll synchronously. 


Indicates that some number of lines that are scrolled off the top of the window 
should be saved and that a scrollbar should be displayed so that those lines can 
be viewed. This option may be turned on and off from the Modes menu. 


Indicates that a scrollbar should not be displayed. 


Indicates that output to a window should not automatically reposition the 
screen to the bottom of the scrolling region. This option can be turned on and 
off from the Modes menu. 


Indicates that output to a window should cause it to scroll to the bottom. 


Indicates that pressing a key while using the scrollbar to review previous lines 
of text should cause the window to be repositioned automatically in the normal 
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postion at the bottom of the scroll region. 


Indicates that pressing a key while using the scrollbar should not cause the 
window to be repositioned. 


Specifies the number of lines to save that have been scrolled off the top of the 
screen. The default is 64. 


Indicates that xterm should start in Tektronix mode, rather than in VT102 
mode. Switching between the two windows is done using the Modes menu. 


Indicates that xterm should start in VT102 mode. 


Indicates that a visual bell is prefered over an audible one. Instead of ringing 
the terminal bell whenever a Control-G is received, the window will be 
flashed. 


Indicates that a visual bell should not be used. 


Indicates that this window should receive console output. This is not sup- 
ported on all systems. 


Indicates that xterm was started by init. In this mode, xterm does not try to 
allocate a new pseudoterminal as init has already done so. In addition, the 
system program gefty is run instead of the user’s shell. This option should 
never be used when starting terminal windows. - 


Specifies the last two letters of the name of a pseudoterminal to use in slave 
mode. This allows xterm to be used as an input and output channel for an 
existing program and is sometimes used in specialized applications. 


The following command line arguments are provided for compatibility with older versions. They may not 
be supported in the next release as the X Toolkit provides standard options that accomplish the same task. — 


% geom 
#geom 


—T string 


—nstring 
—r 


—w number 


Specifies the prefered size and position of the Tektronix window. It is short- 
hand for specifying the *tekGeometry resource. 


Specifies the prefered position of the icon window. It is shorthand for specify- 
ing the *iconGeometry resource. 


Specifies the title for xterm’s windows. It is equivalent to -title. 


Specifies the icon name for xterm’s windows. It is shorthand for specifying 
the *iconName resource. 


Indicates that reverse video should be simulated by swapping the foreground 
and background colors. It is equivalent to -reversevideo or -rv. 


Specifies the width in pixels of the border surrounding the window. It is 
equivalent to -borderwidth or -bw. 


The following standard X Toolkit command line arguments are commonly used with xterm: 


—bg color 


—bd color 
—bw number 
—fg color 
—fn font 


—name name 
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Specifies the color to use for the background of the window. The default is 
white. 


Specifies the color to use for the border of the window. The default is black. 
Specifies the width in pixels of the border surrounding the window. 
Specifies the color to use for displaying text. The default is black. 


Specifies the font to be used for displaying normal text. The default is vtsin- 
gle. 


Specifies the application name under which resources are to be obtained, 
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rather than the default executable file name. 


—Iv Indicates that reverse video should be simulated by swapping the foreground 
and background colors. 

—geometry geometry Specifies the prefered size and position of the VT102 window (see X(1)). 

—display display Specifies the X server to contact (see X(1)). 

~—xrm resourcestring Specifies a resource string to be used. This is especially useful for setting 


resources that do not have separate command line options. 


X DEFAULTS 
The program understands all of the core X Toolkit resource names and classes as well as: 


name (class Name) Specifies the name of this instance of the program. The default is xterm. 


iconGeometry (class IconGeometry) 
Specifies the prefered size and position of the application when iconified. It is 
not necessarily obeyed by all window managers. 


. title (class Title) Specifies a string that may be used by the window manager when displaying 
this application. 


The following resources are specified as part of the vt100 widget (class VT 100): 


font (class Font) Specifies the name of the normal font. The default is vtsingle. 

boldFont (class Font) Specifies the name of the bold font. The default is vtbold. 

¢132 (class C132) Specifies whether or not the VT102 DECCOLM escape sequence should be 
honored. The default is false. 

curses (class Curses) Specifies whether or not the last column bug in cursor should be worked 


around. The default is false. 


background (class Background) 
Specifies the color to use for the background of the window. The default is 
white. 


foreground (class Foreground) 
Specifies the color to use for displaying text in the window. Setting the class 
name instead of the instance name is an easy way to have everything that 
would normally appear in the text color change color. The default is black. 


cursorColor (class Foreground) 
Specifies the color to use for the text cursor. The default is black. 


geometry (class Geometry) 
Specifies the prefered size and position of the VT102 window. 


tekGeometry (class Geometry) 
Specifies the prefered size and position of the Tektronix window. 


internalBorder (class Border Width) 
Specifies the number of pixels between the characters and the window border. 
The default is 2. 


jumpScroll (class JumpScroll) 
Specifies whether or not jump scroll should be used. The default is false. 


logFile (class Logfile) Specifies the name of the file to which a terminal session is logged. The 
default is XtermLog.XXXXX (where XXXXX is the process id of xterm). 


logging (class Logging) | Specifies whether or not a terminal session should be logged. The default is 


1 September 1988 INTEGRATED SOLUTIONS 4 


XTERM (1) X Window System Reference Manual XTERM (1) 


false. 


logInhibit (class LogInhibit) 
Specifies whether or not terminal session logging should be inhibited. The 
default is false. 


loginShell (class LoginShell) 
Specifies whether or not the shell to be run in the window should be started as 
a login shell. The default is false. 


marginBell (class MarginBell) 
Specifies whether or not the bell should be run when the user types near the 
right margin. The default is false. 


multiScroll (class MultiScroll) 
Specifies whether or not asynchronous scrolling is allowed. The default is 


false. 


nMarginBell (class Column) 
Specifies the number of characters from the right margin at which the margin 
bell should be run, when enabled. . 


pointerColor (class Foreground) 
Specifies the color of the pointer. The default is black. 


pointerShape (class Cursor) 
Specifies the name of the shape of the pointer. The default is xterm. 


reverse Video (class ReverseVideo) 
Specifies whether or not reverse video should be simulated. The default is 
false. , 


reverseWrap (class ReverseWrap) 
> Specifies whether or not reverse-wraparound should be enabled. The default 
is false. 


saveLines (class SaveLines) 
Specifies the number of lines to save beyond the top of the screen when a 
scrollbar is turned on. The default is 64. 


scrollBar (class ScrollBar) Specifies whether or not the scrollbar should be displayed. The default is 
false. 


scrollInput (class ScrollCond) 
Specifies whether or not output to the terminal should automatically cause the 
scrollbar to go to the bottom of the scrolling region. The default is true. 


scrollKey (class ScrollCond) 
Specifies whether or not pressing a key should automatically cause the 
scrollbar to go to the bottom of the scrolling region. The default is false. 


signalInhibit (class SignalInhibit) 
. Specifies whether or not the entries in the xterm X11 menu for sending signals 
to xterm should be disallowed. The default is false. 


tekInhibit (class TekInhibit) 
Specifies whether or not Tektronix mode should be disallowed. The default is 
false. 


‘tekStartup (class TekStartup) 
Specifies whether or not xterm should start up in Tektronix mode. The 
default is false. 
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visualBell (class VisualBell) 
Specifies whether or not a visible bell (i.e., flashing) should be used instead of 
an audible bell when Control-G is received. The default is false. 


The following resources are specified as part of the tek4014 widget (class Tek4014): 
width (class Width) Specifies the width of the Tektronix window in pixels. 
height (class Height) Specifies the height of the Tektronix window in pixels. 


The following resources are specified as part of the menu widget: 


menuBorder (class MenuBorder) 
Specifies the size in pixels of the border surrounding menus. The default i is 2, 


menuFont (class Font) Specifies the name of the font to use for displaying menu items. 


menuPad (class MenuPad) 
. Specifies the number of pixels between menu items and the menu border. The 
default is 3. 


EMULATIONS 
The VT102 emulation is fairly complete, but does not support the blinking character attribute nor the 
double-wide and double-size character sets. Termcap(5) entries that work with xterm include xterm, 
vt102, vt100, and ansi; xterm automatically searches the termcap file in this order for these entries and 
then sets the TERM and the TERMCAP environment variables. 


Many of the special xterm features (like logging) may be modified under program control through a set of 
escape sequences different from the standard VT102 escape sequences, 


The Tektronix 4014 emulation supports four different font sizes and five different lines types. The Tek- 
tronix text and graphics commands are recorded internally by xterm and may be written to a file by send- 
ing the COPY escape sequence (or through the Tektronix menu; see below). The name of the file will be 
““COPYyy—-MM-—dd.hh:mmi:ss,’’ where yy, MM, dd, hh, mm, and ss are the year, month, day, hour, 
minute, and second when the COPY was performed (the file is created in the directory xterm is started in, 
or the home directory for a login xterm). 


POINTER USAGE 
Once the VT102 window is created, xterm allows you to select text and copy it within the same or other 
windows. 


The selection functions are invoked when the pointer buttons are used with no modifiers, and when they are 
used with the shift key. 


The left mouse button is used to save text into the cut buffer. Move the cursor to the beginning of the text, 

and then hold the button down while moving the cursor to the end of the region and releasing the button. 

The selected text is highlighted and saved in the global cut buffer when the button is released. Double- 

clicking selects by words. Triple-clicking selects by lines. Quadruple-clicking goes back to characters, 

etc. Multiple-click is determined by the time from button up to button down, so you can change the selec- 
. tion unit in the middle of a selection. 


The middle mouse button types (pastes) the text from the cut buffer, inserting it as keyboard input. 


The right mouse button extends the current selection. (You can swap right and left everywhere in the rest 
of this paragraph.) If pressed while closer to the right edge of the selection than the left, it 
extends/contracts the right edge of the selection. If you contract the selection past the left edge of the 
selection, xterm assumes you really meant the left edge, restores the original selection, then 
extends/contracts the left edge of the selection. Extension starts in the selection unit mode that the last 
selection or extension was performed in; you can multiple-click to cycle through them. 
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By cutting and pasting pieces of text without trailing new lines, you can take text from several places in 
different windows and form a command to the shell, for example, or take output from a program and insert 
it into your favorite editor. Since the cut buffer is globally shared among different applications, you should 
regard it as a file whose contents you know. The terminal emulator and other text programs should be 
treated as if they were a text file (i.e., the text is delimited by new lines). 


The scroll region displays the position and amount of text currently showing in the window (highlighted) 
relative to the amount of text actually saved. As more text is saved (up to the maximum), the size of the 
highlighted area decreases. | 


Clicking the left mouse button with the pointer in the scroll region moves the adjacent line to the top of the 
display window. 
Clicking the right mouse button moves the top line of the display window down to the pointer position. 


Clicking the middle mouse button moves the display to a position in the saved text that corresponds to the 
pointer’s position in the scrollbar. 


Unlike the VT102 window, the Tektronix window does not allow the copying of text. It does allow Tek- 
tronix GIN mode, and in this mode the cursor will change from an arrow to across. Pressing any key will 
send that key and the current coordinate of the cross cursor. Pressing the left, middle, or right mouse but- 
ton will return the letters 1, m, and r, respectively. If the shift key is pressed when a pointer button is 

_ pressed, the corresponding upper case letter is sent. To distinquish a pointer button from a key, the high bit 
of the character is set (but this bit is normally stripped unless the terminal mode is RAW; see tty(4) for 
details). 


MENUS 
Xterm has three different menus, named xterm, Modes, and Tektronix. Each menu pops up under the 
correct combinations of key and button presses. Most menus are divided into two sections, separated by a 
horizontal line. The top portion contains various modes that can be altered. A check mark appears next to 
a mode that is currently active. Selecting one of these modes toggles its state. The bottom portion of the 
menu consists of command entries; selecting one of these performs the indicated function. 


The xterm menu pops up when the control key and pointer button one are pressed in a window. The 
modes section contains items that apply to both the VT102 and Tektronix windows. Notable entries in the 
command section of the menu are Continue, Suspend, Interrupt, Hangup, Terminate, and Kill which 
sends the SIGCONT, SIGTSTP, SIGINT, SIGHUP, SIGTERM, and SIGKILL signals, respectively, to the 
process group of the process running under xterm (usually the shell). The Continue function is especially 
useful if the user has accidentally typed CTRL-Z, suspending the process. 


The Modes menu sets various modes in the VT102 emulation, and is popped up when the control key and 
pointer button two are pressed in the VT102 window. In the command section of this menu, the soft reset 
entry will reset scroll regions. This can be convenient when some program has left the scroll regions set 
incorrectly (often a problem when using VMS or TOPS-20). The full reset entry will clear the screen, reset 
tabs to every eight columns, and reset the terminal modes (such as wrap and smooth scroll) to their initial 
States just after xterm has finished processing the command line options. The Tektronix menu sets vari- 
ous modes in the Tektronix emulation, and is popped up when the control key and pointer button two are 
pressed in the Tektronix window. The current font size is checked in the modes section of the menu. The 
PAGE entry in the command section clears the Tektronix window. 


OTHER FEATURES . 
Xterm automatically highlights the window border and text cursor when the pointer enters the window 
(selected) and unhighlights them when the pointer leaves the window (unselected). If the window is the 
focus window, then the window is highlighted no matter where the pointer is. 


In VT102 mode, there are escape sequences to activate and deactivate an alternate screen buffer, which is 
the same size as the display area of the window. When activated, the current screen is saved and replaced 
with the alternate screen. Saving of lines scrolled off the top of the window is disabled until the normal 
screen is restored. The termcap(5) entry for xterm allows the visual editor vi(1) to switch to the alternate 
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screen for editing, and restores the screen on exit. 


In either VT102 or Tektronix mode, there are escape sequences to change the name of the windows and to 
specify a new log file name. 


ENVIRONMENT 
Xterm sets the environment variables TERM and TERMCAP properly for the size window you have 
created. It also uses and sets the environment variable DISPLAY to specify which bitmap display terminal 
to use. The environment variable WINDOWID is set to the X window id number of the xterm window. 


SEE ALSO 
resize(1), X(1), pty(4), tty(4), termcap(5), vi(1), curses(3X), more(1). 

BUGS 
Xterm will hang forever if you try to paste too much text at one time. It is both producer and consumer for 
the pty and can deadlock. 


Variable-width fonts are not handled reasonably. 


This program still needs to be rewritten. It should be split into very modular sections, with the various 
emulators being completely separate widgets that don’t know about each other. Ideally, you’d like to be 
able to pick and choose emulator widgets and stick them into a single control widget. 


The focus is considered lost if some other client (e.g., the window manager) grabs the pointer; it is difficult 
to do better without an addition to the protocol. 


There needs to be a dialog box to allow entry of log file name and the COPY file name. 
Many of the options are not resettable after xterm starts. 


This manual page is too long. There should be a separate users manual defining all of the non-standard 
escape sequences. 


All programs should be written to use X directly; then we could eliminate this program. 
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NAME 
xwd — dump an image of an X window 


SYNTAX 
xwd [-help] [-nobdrs] [-out file] [-xy] [-display display] 


. DESCRIPTION 

Xwd is an X Window System window dumping utility. Xwd allows X users to store window images in a 
specially formated dump file. This file can then be read by various other X utilities for redisplay, printing, 
editing, formatting, archiving, image processing, etc. The target window is selected by clicking the mouse 
in the desired window. The keyboard bell is rung once at the beginning of the dump and twice when the 


dump is completed. 
OPTIONS 
—help Prints out the ‘‘Usage:’’ command syntax summary. 
—nobdrs Specifies that the window dump should not include the pixels that compose the 
X window border. This is useful in situations where you may wish to include the 
window contents in a document as an illustration. 
—out file _ Allows you to explicitly specify the output file on the command line. The default 
is to Output to standard out. | 
—xy Applies to color displays only. It selects ‘“XY’’ format dumping instead of the 
default *“Z”’ format. 
—display display Allows you to specify the server to connect to (see X(1)). 
ENVIRONMENT 
DISPLAY To get default host and display number. 
FILES 
XWDFile.h X Window Dump File format definition file. 
SEE ALSO 


xwud(1), xpr(1), xdpr(1), X(1) 
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NAME 
xwininfo — window information utility for X 


SYNTAX 
xwininfo [-help] [-id id] [-root] [-name name] [-int] [-tree] [-stats] [-bits] [-events] [-size] [-wm ] [-all] [- 
display display] 


DESCRIPTION 
Xwininfo is a utility for displaying information about windows. Depending on which options are 
chosen, various information is displayed. If no options are chosen, -stats is assumed. 


The user has the option of selecting the target window with the mouse (by clicking any mouse button in 
the desired window) or by specifying its window id on the command line with the -id option. In addition, 
if it is easier, instead of specifying the window by its id number, the -name option may be used to specify 
which window is desired by name. There is also a special -root option to quickly obtain information on 


X’s root window. 
OPTIONS 

—help Prints out the ““Usage:’’ command syntax summary. 

—id id Allows the user to specify a target window id on the command line rather than 
using the mouse to select the target window. This is very useful in debugging X 
applications where the target window is not mapped to the screen or where the 
use of the mouse might be impossible or interfere with the application. 

—name name - Allows the user to specify that the window named name is the target window on 
the command line rather than using the mouse to select the target window. 

—root Specifies that X’s root window is the target window. This is useful in situations 

where the root window is completely obscured. 

~int . Specifies that all X window ids should be displayed as integer values. The 
default is to display them as hexadecimal values. 

—tree Causes the selected window’s root, parent, and children windows id’s and name’s 
to be displayed. 

—stats Causes various attributes having to do with location and appearance of the 


selected window to be displayed. Information displayed includes the location of 
the window, its width and height, its depth, border width, class, and map state. 


—bits Causes various attributes of the selected window having to do with raw bits and 
how it is to be stored to be displayed. Information displayed includes the 
window’s window and bit gravities, the window’s backing store hint and 
backing_planes value, its backing pixel, and whether or not the window has save- 


under set. 
—events Causes the selected window’s event masks to be displayed. Both the event mask 
of events wanted by some client and the event mask of events not to prograte are 
displayed. . ; 
—size Causes the selected window’s sizing hints to be displayed. Information displayed 


for both the normal size hints and the zoom size hints includes: the user supplied 
location if any, the program supplied location if any, the user supplied size if any, 
the program supplied size if any, the minimum size if any, the maximum size if 
any, the resize increments if any, and the minimum and maximum aspect ratios if 
any. 


—wm Causes the selected window’s window manager hints to be displayed. Informa- 
tion displayed may include: whether or not the application accepts input, what the 
window’s icon window # and name is, where the window’s icon should go, and 
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what the window’s initial state should be. 


—all Asks for all information possible. 
—display display Allows you to specify the server to connect to; see X(1). 
EXAMPLE 


The following is a sample summary taken with no options specified: 


xwininfo ==> Please select the window you wish 
==> information on by clicking the 
==> mouse in that window. 


xwininfo ==> Window id: 0x8006b (fred) 


==> Upper left X: 0 

==> Upper left Y: 0 

==> Width: 1024 

==> Height: 864 

==> Depth: 1 

==> Border width: 0 

==> Window class: InputOutput 

==> Window Map State: IsUnviewable 


ENVIRONMENT 
DISPLAY To get default host and display number. 


SEE ALSO 
X(1), xprop(1) 
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NAME 
xwud — image displayer for X 


SYNTAX 
xwud [-help] [-inverse] [-in file] [-display display] 


DESCRIPTION 
Xwud is an X Window System window image undumping utility. Xwud allows X users to display win- 
dow images that were saved in a specially formatted dump file. The window image will appear at the 
coordinates of the original window from which the dump was taken. This is a crude version of a more 
advanced utility that has never been written. Monochrome dump files are displayed on a color monitor in 
‘the default foreground and background colors. 


OPTIONS 
—help Prints out a short description of the allowable options. 
~in file Allows you to explicitly specify the input file on the command line. The default is 
to take input from standard in. 
—inverse Applies to monochrome window dump files only. If selected, the window is 
undumped in reverse video. This is mainly needed because the display is ‘‘write 
white,’’ whereas dump files intended eventually to be written to a printer are gen- 
erally “‘write black.”’ 
—display display Allows you to specify the server to connect to (see X(1)). 
ENVIRONMENT 

DISPLAY To get default display. 
FILES 

XWDFile.h X Window Dump File format definition file. 
BUGS 


Does not attempt to do color translation when the destination screen does not have a colormap exactly 
matching that of the original window. 


SEE ALSO 
xwd(1), xpr(1), xdpr(1), X(1) 
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NAME 
XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAc- 


cessControl, XDisableAccessControl — control host access 


SYNTAX 
XAddHost (display, host) 
Display *display; 
XHostAddress *host; 
XAddHosts( display, hosts, num_hosts) 
Display *display; 
XHostAddress *hosts; 


int num_hosts; 
XHostAddress *XListHosts (display, nhosts_return, state_return) 
Display *display; 
int *nhosts_return; 
Bool *state_return; 
XRemoveHost (display, host) 
Display *display; 
XHostAddress *host; 
XRemoveHosts (display, hosts, num_hosts) 
Display «display; 
XHostAddress *hosts; 
int num_hosts; 


XSetAccessControl (display, mode) 


Display *display; 
int mode; 
XEnableAccessControl (display) 
Display *display; 
XDisableAccessControl (display) 
Display *display; 
OPTIONS 
display Specifies the connection to the X server. 
mode Specifies whether you want to change the access control to enable or disable. 
EnableAccess enables host access control. DisableAccess disables host access 
control. 
host Specifies the network address of the host machine. 
hosts Specifies each host that is to be added. 
nhosts_return Returns the number of hosts currently in the access control list. 
num_hosts Specifies the number of hosts. 
state_return Returns the state of the access control (enabled or disabled). 
DESCRIPTION 


The XAddHost function adds the specified host to the access control list for that display. The display 
hardware must be on the same host as the program issuing the command. 


The XAddHosts function adds each specified host to the access control list for that display. The display 
hardware must be on the same host as the program issuing the command. 
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The XListHosts function returns the current access control list as well as whether the use of the list at con- 
nection setup was enabled or disabled. 


The XRemoveHost function removes the specified host from the access control list for that display. The 
display hardware must be on the same host as the client process. 


The XRemoveHosts function removes each specified host from the access control list for that display. The 
display hardware must be on the same host as the client process. 


The XSetAccessControl function either enables or disables the use of the access control list at connection 
setups. 


The XEnableAccessControl function enables the use of the access control list at connection setups. 
The XDisableAccessControl function disables the use of the access control list at connection setups. 


XAddHost, XAddHosts, XRemoveHost, and XRemoveHosts can generate BadAlloc and BadValue 
errors. 


XSetAccessControl can generate BadAlloc and BadValue errors. 
XEnableAccessControl and XDisableAccessControl can generate a BadAccess error. 


DIAGNOSTICS 

BadAccess A client attempted to modify the access control list from other than the local (or other- 
wise authorized) host. 

BadAlloc The server failed to allocate the requested resource or server memory. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XAllocColor, XAllocNamedColor, XAllocColorCells, XAllocColorPlanes, XFreeColors — allocate and 


free colors 


SYNTAX 
Status XAllocColor (display, cmap, screen_in_out) 
Display *display; 
Colormap cmap; 
XColor *screen_in_out; 


Status XAllocNamedColor (display, cmap, color_name, visual_def return, exact_def_return) 
Display *display; 
Colormap cmap; 
char *color_name; 
XColor *visual_def_return, *exact_def return; 


Status XAllocColorCells (display, cmap, contig, plane_masks_return, nplanes, 
pixels_return, ncolors) | 
Display *display; 
Colormap cmap; 
Bool contig; 
unsigned long plane_masks_return[]; 
unsigned int nplanes; 
unsigned long pixels_return{]; 
unsigned int ncolors; 


Status XAllocColorPlanes (display, cmap, contig, pixels_return, ncolors, nreds,ngreens, 
nblues, rmask_return, gmask_return, bmask_return) 
Display *display; 
Colormap cmap; 
Bool contig; 
unsigned long pixels_return{]; 
int ncolors; 
int nreds, ngreens, nblues; 
unsigned long *rmask_return, *gmask_return, *bmask_return; 


XFreeColors (display, cmap, pixels, npixels, planes) 


Display *display; 
Colormap cmap; 
unsigned long pixels[]; 
int npixels; 
unsigned long planes; 
OPTIONS 
cmap Specifies the colormap ID. 
color_name Specifies the color name string (for example, ‘‘red’’) whose color definition struc- 
ture you want returned. 
contig Specifies a boolean value. You pass the value 1 if the planes must be contiguous 
or the value 0 if the planes do not need to be contiguous. 
display Specifies the connection to the X server. 
exact_def_return Returns the exact RGB values. 
ncolors Specifies the number of pixel values that are to be returned in the pixels_return 
array. 
npixels Specifies the number of pixels. 
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nplanes Specifies the number of plane masks that are to be returned in the plane masks 
array. 

nreds 

ngreens 

nblues Specifies the number of red, green, and blue colors (shades). The value you pass 
must be non-negative. 

pixels Specifies an array of pixel values. 

pixels_return | Returns an array of pixel values. 


plane_masks return Returns an array of plane masks. 
planes Specifies the planes you want to free. 


rmask return 
gmask_return 
bmask_return Returns bit masks for the red, green, and blue planes. 


screen_in_out Specifies or returns the values actually used in the colormap. 
visual_def_return Returns the closest RGB values provided by the hardware. 


DESCRIPTION 
The XAllocColor function allocates a read-only colormap entry corresponding to the closest red, green, 
and blue values supported by the hardware. XAllocColor returns the pixel value of the color closest to the 
specified RGB elements supported by the hardware and returns the red, green, and blue values actually 
used. XAllocColor can generate BadAlloc and BadColor errors. 


The XAllocNamedColor function looks up the named color with respect to the screen that is associated 
with the specified colormap. Both the exact data base definition and the closest color supported by the 
screen are returned. XAllocNamedColor can generate BadAlloc and BadColor errors. 


The XAllocColorCells function allocates read/write color cells. The number of colors must be positive 
and the number of planes nonnegative. XAllocColorCells can generate BadAlloc, BadColor, and Bad- 
Value errors. 


The XAllocColorPlanes function allocates read/write color resources in a way that is compatible with 
DirectColor displays. XAllocColorPlanes can generate BadAlloc, BadColor, and BadValue errors. 


The XFreeColors function frees the cells represented by pixels whose values are in the pixels array. 
XFreeColors can generate BadAccess, BadColor, and BadValue errors. 


DIAGNOSTICS 

BadAccess A client attempted to free a colormap entry that it did not already allocate. 

BadAccess A client attempted to store into a read-only colormap entry. 

BadAlloc The server failed to allocate the requested resource or server memory. 

BadColor A value for a Colormap argument does not name a defined Colormap. 

BadName A font or color of the specified name does not exist. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XCreateColormap(3X), XQueryColor(3X), XStoreColors(3X) 
Xlib — C Language X Interface 
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NAME 
XAllowEvents — continue frozen event processing 
SYNTAX 
XAllowEvents (display, event_mode,, time) 
Display *display; 
int event_mode; 
Time time; 
OPTIONS 
display Specifies the connection to the X server. 
event_mode Specifies the event mode. You can pass one of these constants: AsyncPointer, 
SyncPointer, AsyncKeyboard, SyncKeyboard, ReplayPointer, ReplayKey- 
board, AsyncBoth, or SyncBoth. 
time Specifies the time. You can pass either a timestamp, expressed in milliseconds, or 
CurrentTime. 
DESCRIPTION 


The XAllowEvents function releases some queued events if the client has caused a device to freeze. XAI- 
lowEvents can generate a Bad Value error. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by.the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type .. zg 
is accepted. Any argument defined as a set of alternatives can generate this error. 
SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XChangeKeyboardControl, © XGetKeyboardControl, XAutoRepeatOn, XAutoRepeatOff, XBell, 
XQueryKeymap — manipulate keyboard settings 


SYNTAX 
XChangeKeyboardControl (display, value_mask, values) 
Display *display; 
unsigned long value_mask; 
XKeyboardControl *values ; 


XGetKeyboardControl (display, values_return) 
Display *display; 
XKeyboardState *values_return; 


XAutoRepeatOn (display) 


Display *display; 
XAutoRepeatOff (display) 
Display *display; 
XBell (display, percent) 
Display *display; 
int percent; 
XQueryKeymap (display, keys_return) 
Display *display; 
char keys_return[32]; 
OPTIONS 
display Specifies the connection to the X server. 
keys_return Returns an array of bytes that identifies which keys are pressed down. Each bit 
represents one key of the keyboard. 
percent Specifies the base volume for the bell, which can range from -100 to 100 
inclusive. 
value_mask Specifies one value for each one bit in the mask (least to most significant bit). The 
values are associated with the set of keys for the previously specified keyboard. 
values Specifies a pointer to the structure XKeyboardControl. 
values_return Returns the current keyboard parameter in the specified XKeyboardState struc- 
ture. 
DESCRIPTION 


The XChangeKeyboardControl function controls the keyboard characteristics defined by the XKey- 
boardControl structure. XChangeKeyboardControl can generate BadMatch and Bad Value errors. 


The XGetKeyboardControl function returns the current control values for the keyboard to the XKey- 
boardState structure. 


The XAutoRepeatOn function turns on auto-repeat for the keyboard on the specified display. 
The XAutoRepeatOff function turns off auto-repeat for the keyboard on the specified display. 


The XBell function rings the bell on the keyboard on the specified display, if possible. XBell can generate 
a BadValue error. | 


The XQueryKeymap function returns a bit vector for the logical state of the keyboard, where each one bit 
indicates that the corresponding key is currently pressed down. 
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DIAGNOSTICS 

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XChangeKeyboardMapping(3X), XSetPointerMapping(3X) 
Xlib — C Language X Interface 
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NAME 
XChangeKeyboardMapping, XGetKeyboardMapping, XSetModifierMapping, XGetModifierMapping, 
XNewModifierMap, XInsertModifiermapEntry, XDeleteModifiermapEntry, XFreeModifierMap — manipu- 
late keyboard encoding 


SYNTAX 

XChangeKeyboardMapping( display, first_keycode, keysyms_per_keycode, keysyms, num_codes) 
Display *display; 
int first_keycode; 
int keysyms_per_keycode; 
KeySym *keysyms; 
int num_codes; 

KeySym *XGetKeyboardMapping( display, first_keycode_wanted, keycode_count, 

keysyms_per_keycode_return) 

Display *display; 
KeyCode first_keycode_wanted; 
int keycode_count; 
int *keysyms_per_keycode_return; 


int XSetModifierMapping( display, modmap) 
Display *display; 
XModifierKeymap *modmap; 
XModifierKeymap *XGetModifierMapping( display) 
Display *display; 


XModifierKeymap *XNewModifierMap(max_keys_per_mod) 
int max_keys_per_mod; 


XModifierKeymap *XInsertModifiermapEntry (modmap, keysym_entry, modifier) 


XModifierKeymap *modmap; 

KeyCode keysym_entry; 

int modifier; 
XModifierKeymap *XDeleteModifiermapEntry (modmap, keysym_entry, modifier) 

XModifierKeymap *modmap; 

KeyCode keysym_entry; 

int modifier; 
XFreeModifierMap(modmap) 

XModifierKeymap *modmap; 
OPTIONS 

keycode_count Specifies the number of keycodes that are to be returned. 
display Specifies the connection to the X server. 
first_keycode Specifies the first keycode that is to be changed. 
first_keycode_wanted Specifies the first keycode that is to be returned. 
keysyms Specifies a pointer to an array of keysyms. 
keysym_entry Specifies the keysyms. 
keysyms_per_keycode Specifies the keysyms that are to be used. 


keysyms_per_keycode_return Returns the number of keysyms per keycode. 


max_keys_per_mod Specifies the maximum number of keycodes assigned to any of the 
modifiers in the map. 
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modifier Specifies the modifier. 

modmap Specifies a pointer to the XModifierKeymap structure. 

num_codes Specifies the number of keycodes that are to be changed. 
DESCRIPTION 


The XChangeKeyboardMapping function, starting with first_keycode, defines the symbols for the 
specified number of keycodes. XChangeKeyboardMapping can generate BadAlloc, BadLength, and 
BadValue errors. 


The XGetKeyboardMapping function, starting with first_keycode, returns the symbols for the specified 
number of keycodes. XGetKeyboardMapping can generate a BadValue error. 


The XSetModifierMapping function specifies the keycodes of the keys, if any, that are to be used as 
modifiers. XSetModifierMapping can generate BadAlloc and BadValue errors. 


The XGetModifierMapping function returns a newly created XModifierKeymap structure that contains 
the keys being used as modifiers. 


The XNewModifierMapping function returns a XModifierKeymap structure. 


The XInsertModifiermapEntry function add the specified keycode to the set that controls the specified 
modifier and returns the resulting XModifierKeymap structure (expanded as needed). 


The XDeleteModifiermapEntry function deletes. the specified keycode from the set that controls the 
specified modifier and returns the resulting XModifierKeymap structure. 


The XFreeModifierMapping function frees the specified XModifierKeymap structure. 


DIAGNOSTICS 

BadAlloc The server failed to allocate the requested resource or server memory. 

BadValue, Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XSetPointerMapping(3X) 
Xlib — C Language X Interface 
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NAME 
XChangePointerControl, XGetPointerControl — control pointer 


SYNTAX 
XChangePointerControl (display, do_accel, do_threshold, accel_numerator , 
accel_denominator, threshold) 
Display *display; 
Bool do_accel, do_threshold; 
int accel_numerator , accel_denominator; 
int threshold; 


XGetPointerControl (display, accel_numerator_return, accel_denominator_return, 
threshold_return) 
Display *display; 
int *accel_numerator_return, *accel_denominator_return; 
int *threshold_return; 


OPTIONS © 
accel_denominator Specifies the denominator for the acceleration multiplier. 


accel_denominator_return Returns the denominator for the acceleration multiplier. 


accel_numerator Specifies the numerator for the acceleration multiplier. 
accel_numerator_return Returns the numerator for the acceleration multiplier. 

display Specifies the connection to the X server. 

do_accel Specifies a boolean value that controls whether the values for the 


accel numerator or accel denominator are set. You can pass one of 
these constants: True or False. 


do_threshold Specifies a boolean value that controls whether the value for the 
accel_numerator or accel denominator are set. You can pass one of 
these constants: True or False. 


threshold Specifies the acceleration threshold. 
threshold_return Returns the acceleration threshold. 
DESCRIPTION 


The XChangePointerControl function defines how the pointing device moves. XChangePointerControl 
can generate a BadValue error. 


The XGetPointerControl function returns the pointer’s current acceleration multiplier and acceleration 


threshold. 
DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 
SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XChangeSaveSet, XAddToSaveSet, XRemoveFromSaveSet — change a client’s save set 


SYNTAX 
XChangeSaveSet (display, w, change_mode) 
Display *display; 
Window w; 
int change_mode; 


XAddToSaveSet (display, w_add) 


Display *display; 
Window w_add; 
XRemoveFromSaveSet( display, w_remove) 
Display *display; 
Window w_remove ; 
OPTIONS 
change_mode Specifies the mode. You can pass one of SetModeInsert or SetModeDelete. If 
SetModelInsert, XChangeSaveSet adds the window to this client’s save-set. If 
SetModeDelete, XChangeSaveSet deletes the window from this client’s save-set. 
display Specifies the connection to the X server. 
w Specifies the window ID. 
w_add Specifies the window ID of the window whose children you want to add to the 
client’s save-set. 
w_remove Specifies the window ID of the window whose children you want to remove from 
the client’s save-set. 
DESCRIPTION 


Depending on the constant you passed to the change_mode argument, the XChangeSaveSet function 
either adds or removes a subwindow from the client’s save-set. XChangeSaveSet can generate BadMatch, 
BadValue, and BadWindow errors. 


The XAddToSaveSet function adds the children of the specified window to the client’s save-set. 
XAddToSaveSet can generate BadMatch and BadWindow errors. 


The XRemoveFromSaveSet function removes the children of the specified window from the client’s 
save-set. XRemoveFromSaveSet can generate BadMatch and BadWindow errors. 


DIAGNOSTICS 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XReparentWindow(3X) 
Xlib — C Language X Interface 
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NAME 
XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWin- 
dowBorder, XSetWindowBorderPixmap — change window attributes 


SYNTAX 
XChangeWindowAttributes (display, w, valuemask, attributes) 
Display *display; 
Window w; 
unsigned long valuemask; 


- KSetWindowAttributes *attributes; 
XSetWindowBackground (display, w, background_pixel) 
Display *display; 
Window w; 
unsigned long background_pixel; 


XSetWindowBackgroundPixmap (display, w, background_pixmap) 


Display *display; 
Window w; 
Pixmap background_pixmap; 
XSetWindowBorder (display, w, border_pixel) 
Display *display; 
Window w; 
unsigned long border_pixel; 
XSetWindowBorderPixmap (display, w, border_pixmap) 
Display *display; 
Window w; 
Pixmap border_pixmap; 
OPTIONS 
attributes Attributes of the window to be set at creation time should be set in this structure. 


The valuemask should have the appropriate bits set to indicate which attributes 
have been set in the structure. 


background _pixel Specifies the pixel of the background. This pixel value determines which entry in 
the colormap is used. 


background_pixmap Specifies the background pixmap. If a Pixmap ID is specified, the background is 
painted with this pixmap. If None, no background is painted. If ParentRelative, 
the parent’s pixmap is used. 


border_pixel Specifies the entry in the colormap. 


border_pixmap Specifies the border pixmap. If you specify a pixmap ID, the associated pixmap is 
used for the border. If CopyFromParent is specified, a copy of the parent 
window’s border pixmap is used. 


display Specifies the connection to the X server. 


valuemask Specifies which window attributes are defined in the attributes argument. This 
mask is the bitwise inclusive OR of the valid attribute mask bits. If valuemask is 
zero, the attributes are ignored and are not referenced. 


Ww Specifies the window ID. 


DESCRIPTION 
Depending on the valuemask, the XChangeWindowAttributes function uses the window attributes in the 
XSetWindowAttributes structure to change the specified window attributes. XChangeWindowAttri- 
butes can generate BadAccess, BadColor, BadCursor, BadMatch, BadPixmap, BadValue, and 
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BadWindow errors. 


The XSetWindowBackground function sets the background pixel of the window to the pixel value you 
specify. XSetWindowBackground can generate BadMatch and Bad Window errors. 


The XSetWindowBackgroundPixmap function sets the background pixmap of the window to the pixmap 
you specify. XSetWindowBackgroundPixmap can generate BadColor, BadMatch, BadPixmap, and 
BadWindow errors. 


The XSetWindowBorder function sets the border pixel of the window to the pixel value you specify. It 
uses this value as an entry into the colormap to determine which color is to be used to paint the border. 
XSetWindowBorder can generate BadMatch, BadPixmap, BadValue, and BadWindow errors. 


The XSetWindowBorderPixmap function sets the border pixmap of the window to the pixmap you 
specify. It uses this entry for the border. XSetWindowBorderPixmap can generate BadMatch, BadPix- 
map, BadValue, and Bad Window errors. 


DIAGNOSTICS 
BadAccess A client attempted to free a colormap entry that it did not already allocate. 
BadAccess A Client attempted to store into a read-only colormap entry. 
BadColor A value for a colormap argument does not name a defined colormap. 
BadCursor A value for a cursor argument does not name a defined cursor. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. 
BadMatch An InputOnly window locks this attribute. 
BadPixmap A value for a pixmap argument does not name a defined pixmap. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XConfigureWindow(3X), XCreateWindow(3X), XDestroyWindow(3X), © XMapWindow(3X), 
XRaiseWindow(3X), XUnmap Window(3X) 
Xlib — C Language X Interface 
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NAME 


XClearArea, XClearWindow — clear windows 
SYNTAX 
XClearArea (display, w, x,y, width, height, exposures) 
Display *display; 
Window w; 
int x, y; 
unsigned int width, height; 
Bool exposures; 
XClearWindow (display, w) 
Display *display; 
Window w; 
OPTIONS 
display Specifies the connection to the X server. 
exposures Specifies a boolean value of True or False. 
Ww Specifies the window ID. 
width 
height Specify the width and height. 
x 
y Specify the x and y coordinates. 
DESCRIPTION 


The XClearArea function paints a rectangular area in the specified window according to the specified 
dimensions with the window’s background pixel or pixmap. XClearArea can generate BadMatch, Bad- 
Value, and Bad Window errors. 


The XClearWindow function clears the entire area in the specified window and is equivalent to 
XClearArea (display, w, 0, 0, 0, 0, False ). XClearWindow can generate BadMatch, BadValue, and 
BadWindow errors. 


DIAGNOSTICS 
BadMatch An InputOnly window is used as a Drawable. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a Window argument does not name a defined Window. 


SEE ALSO 
XCopyArea(3X) 
Xlib — C Language X Interface 
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NAME 
XConfigureWindow, XMoveWindow, XResizeWindow, XMoveResizeWindow, XSetWindowBor- 


derWidth — configure windows 


SYNTAX 
XConfigureWindow (display, w, value_mask, values) 
Display *display; 
Window w; 


unsigned int value_mask; 
XWindowChanges *values; 


XMoveWindow (display, w, x, y) 
Display *display; 
Window w; 
int x, y; 
XResize Window ( display, w, width, height) 
Display *display; 
Window w; 
unsigned int width, height; 


XMoveResize Window (display, w, x, y, width, height) 
Display *display; 
Window w; 
int x, y; 
unsigned int width, height; 
XSetWindowBorder Width( display, w, width) 


Display *display; 
Window w; 
unsigned int width; 
OPTIONS 
display . Specifies the connection to the X server. 
value_mask Specifies which values are to be set using information in the values structure. This 
mask is the bitwise inclusive OR of the valid change window values bits. 
values Specifies a pointer to the structure XWindowChanges. 
w Specifies the window ID. 
width 
height Specifies the width and height. 
x 
y Specifies the x and y coordinates. 
DESCRIPTION 


The XConfigureWindow function uses the values specified in the XWindowChanges structure to 
reconfigure a window’s size, position, border, and stacking order. XConfigureWindow can generate Bad- 
Match, BadValue, and BadWindow errors. 

The XMoveWindow function moves the specified window to the specified x and y coordinates. This func- 
tion does not change the window’s size, does not raise the window, and does not change the mapping state 
of the window. XMoveWindow can generate a BadWindow error. 


The XResizeWindow function changes the inside dimensions of the specified window, not including its 
borders. This function does not change the window’s upper-left coordinate or the origin and does not raise 
the window. XResizeWindow can generate a BadWindow error. 
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The XMoveResizeWindow function changes the size and location of the specified window without raising 
it. XMoveResizeWindow can generate BadMatch, BadValue, and Bad Window errors. 


The XSetWindowBorder Width function sets the specified window’s border width to the specified width. 
XSetWindowBorderWidth can generate Bad Value and Bad Window errors. 


DIAGNOSTICS 
BadMatch An InputOnly window is used as a Drawable. 


BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XChangeWindowAttributes(3X), XCreateWindow(3X), XDestroyWindow(3X), XMapWindow(3X), 
XRaiseWindow(3X), XUnmapWindow(3X) 
Xlib — C Language X Interface 
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NAME 
XCopyArea, XCopyPlane — copy areas 
SYNTAX 
XCopyArea (display, src, dest, gc, src_x, src_y, width, height, dest_x, dest_y) 
Display *display; 
Drawable src, dest; 
GC ge; 


int src_xX, STC_y; 
unsigned int width, height; 
int dest_x, dest_y; 


XCopyPlane( display, src, dest, gc, src_x, src_y, width, height, dest_x, dest_y, plane) 


Display *display; 
Drawable src, dest; 
GC ge; 
int src_x, STC_y; 
unsigned int width, height; 
int dest_x, dest_y; 
unsigned long plane; 
OPTIONS 
dest_x 
dest_y Specifies the x and y coordinates of the destination rectangle relative to its origin. 
These coordinates specify the upper-left corner of the destination rectangle. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
plane Specifies the bit-plane. You must set exactly one bit. 
src 
dest Specifies the source and destination rectangles to be combined. 
src_x 
src_y Specifies the x and y coordinates of the source rectangle relative to its origin. 
These coordinates specify the upper-left corner of the source rectangle. 
width 
height Specifies the width and height. 
DESCRIPTION 


The XCopyArea function combines the specified rectangle of sre with the specified rectangle of dest. 
XCopyArea can generate BadDrawable, BadGC, and BadMatch errors. 


The XCopyPlane function uses a single bit plane of the specified source rectangle combined with the 
specified GC to modify the specified rectangle of dest. XCopyPlane can generate BadDrawable, BadGC, 
BadMatch, and BadValue errors. 


DIAGNOSTICS 
BadDrawable A value for a drawable argument does not name a defined window or pixmap. 
BadGC A value for a GContext argument does not name a defined GContext. 


BadMatch — An InputOnly window is used as a drawable. 


BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
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is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
XClearArea(3X) 
Xlib — C Language X Interface 
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NAME 
XCreateColormap, XCopyColormapAndFree, XFreeColormap, XSetWindowColormap — create, copy, or 
destroy colormaps 
SYNTAX 
Colormap XCreateColormap (display, w, visual, alloc) 
Display *display; 
Window w; 
Visual *visual; 
int alloc; 


Colormap XCopyColormapAndFree (display, cmap) 
Display *display; 
Colormap cmap; 
XFreeColormap (display, cmap) 
Display *display; 
Colormap cmap; 


XSetWindowColormap (display, w, cmap) 


Display *display; 
Window w; 
Colormap cmap; 
OPTIONS 
alloc Specifies the colormap entries to be allocated. You can pass one of these con- 
stants: AllocNone or AllocAll. 
cmap Specifies the colormap ID. 
display Specifies the connection to the X server. 
visual Specifies a pointer to a visual type supported on the screen. If the visual type is 
not one supported by the screen, the function returns a BadMatch error. 
w Specifies the window ID. | 
DESCRIPTION 


The XCreateColormap function creates a colormap of the specified visual type for the screen on which 
the specified window resides and associates the colormap ID with it. XCreateColormap can generate 
BadAlloc, BadMatch, BadValue, and Bad Window errors. 


The XCopyColormapAndFree function obtains a new colormap when allocating out of a previous color- 
map has failed due to resource exhaustion (that is, too many cells or planes were in use in the original 
colormap). XCopyColormapAndFree can generate BadAlloc and BadColor errors. 


The XFreeColormap function deletes the association between the colormap resource ID and the colormap. 
However, this function has no effect on the default colormap for a screen. XFreeColormap can generate a 
BadColor error. 


The XSetWindowColormap function sets the specified colormap of the specified window. XSetWin- 
dowColormap can generate BadColor, BadMatch, and Bad Window errors. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadColor A value for a colormap argument does not name a defined colormap. 
BadMatch An InputOnly window is used as a drawable. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. 
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BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XAllocColor(3X), XQueryColor(3X), XStoreColors(3X) 
Xlib — C Language X Interface 
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NAME 
XCreateFontCursor, XCreatePixmapCursor, XCreateGlyphCursor — create cursors 


SYNTAX 
#include <X11/cursorfont.h> 


Cursor XCreateFontCursor (display, shape) 
Display *display; 
unsigned int shape; 
Cursor XCreatePixmapCursor (display, source, mask, foreground_color, background_color,x,y) 
Display *display; 
Pixmap source; 
Pixmap mask; 
XColor *foreground_color; 
XColor *background_color; 
unsigned int x, y; 


Cursor XCreateGlyphCursor (display, source_font, mask_font, source_char, mask_char, 
foreground_color, background_color) 
Display *display; 
Font source_font, mask_font; 
unsigned int source_char, mask_char;, 
XColor *foreground_color; 
XColor *background_color; 


amc eere rete Specifies the red, green, and blue (RGB) values for the background of the source. 
display Specifies the connection to the X server. 
mask Specifies the source bits of the cursor that are to be displayed. You can also pass 
None. 
mask_char Specifies the glyph character for the mask. 
mask_font Specifies the font for the mask glyph. You can also pass None. 
source_char Specifies the character glyph for the source. 
foreground_color Specifies the red, green, and blue (RGB) values for the foreground of the source. 
source_font Specifies the font for the source glyph. 
shape Specifies the shape in which you want to create the standard cursor. 
source Specifies the shape of the source cursor. 
x 
y Specifies the x and y coordinates. 
DESCRIPTION 


The XCreateFontCursor function creates a cursor from a standard font. XCreateFontCursor can gen- 
erate BadAlloc, BadMatch, and BadValue errors. 


The XCreatePixmapCursor function creates a cursor and returns the cursor ID associated with it. 
XCreatePixmapCursor can generate BadAlloc, BadMatch, and BadPixmap errors. 


The XCreateGlyphCursor function is similar to XCreatePixmapCursor and creates a cursor from font 
glyphs. For XCreateGlyphCursor, however, the source and mask bitmaps are obtained from the specified 
font glyphs. XCreateGlyphCursor can generate BadAlloc, BadFont, and BadValue errors. 
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DIAGNOSTICS 
BadAlloc . The server failed to allocate the requested resource or server memory. 
BadFont A value for a font or GContext argument does not name a defined font. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. . 
BadPixmap A value for a pixmap argument does not name a defined pixmap. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
XDefineCursor(3X), XRecolorCursor(3X) 
Xlib — C Language X Interface 
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NAME 
XCreateGC, XCopyGC, XChangeGC, XFreeGC — create and free graphics contexts 
SYNTAX 
GC XCreateGC (display, d, valuemask_create , values) 
Display *display; 
Drawable d; 
unsigned long valuemask_create; 
XGCValues * values; 
XCopyGC (display, src, valuemask_copy , dest) 
Display *display; 
GC src, dest; 


unsigned long valuemask_copy; 
XChangeGC (display, gc, valuemask_change , values) 


Display *display; 
GC gc; 
unsigned long valuemask_change ; 
XGCValues * values; 
XFreeGC (display, gc) 
Display *display; 
GC gc; 
OPTIONS 
d Specifies the drawable. 
dest Specifies the destination graphics context. 
display Specifies the connection to the X server. 
ge Specifies the graphics context. 
src Specifies the components of the source graphics context. 


XCreateGC (3X) 


valuemask_change Specifies which components in the graphics context are to be changed using infor- 
mation in the XGC Values structure. This argument is the bitwise inclusive OR of 


one or more of the valid GC component masks. 


valuemask_copy Specifies which components in the source graphics context are to be copied to the 
destination graphics context. This argument is the bitwise inclusive OR of one or 


more of the valid GC component masks. 


valuemask_create Specifies which components in the graphics context are to be set using informa- 
tion in the XGCValues structure. This argument is the bitwise inclusive OR of 


one or more of the valid GC component masks. 
values Specifies a pointer to the XGC Values structure. 
DESCRIPTION 


The XCreateGC function creates a graphics context and returns aGC. XCreateGC can generate BadAl- 


loc, BadDrawable, BadFont, BadMatch, BadPixmap, and BadValue errors. 


The XCopyGC function copies the specified components from the source graphics context to the destina- 
tion graphics context. XCopyGC can generate BadAlloc, BadGC, BadMatch, and BadValue errors. 


The XChangeGC function changes the components specified by the valuemask_change argument for the 
specified graphics context. XChangeGC can generate BadAlloc, BadFont, BadGC, BadMatch, BadPix- 


map, and BadValue errors. 


1 September 1988 INTEGRATED SOLUTIONS 


XCreateGC (3X) 


X Window System Reference Manual XCreateGC (3X) 


The XFreeGC function destroys the specified graphics context as well as the shadow copy. 
XFreeGC can generate a BadGC error. 


DIAGNOSTICS 
BadAlloc 


BadDrawable 
BadFont 
BadGC 
BadMatch 
BadMatch 


BadPixmap 
BadValue 


SEE ALSO 


The server failed to allocate the requested resource or server memory. 

A value for a drawable argument does not name a defined window or pixmap. 
A value for a font or GContext argument does not name a defined font. 

A value for a GContext argument does not name a defined GContext. 

An InputOnly window is used as a drawable. 


Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 


A value for a pixmap argument does not name a defined pixmap. 


Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), XSetFont(3X), 
XSetLineAttributes(3X), XSetState(3X), XSetTile(3X). . 
Xlib — C Language X Interface 
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XCreateImage, XGetPixel, XPutPixel, XSubImage, XAddPixel, XDestroyImage — image utilities 


SYNTAX 


XImage *XCreateImage( display, visual, depth, format, offset, data, width, height, bitmap_pad, 
bytes_per_line) 


Display *display; 
Visual *visual; 
unsigned int depth; 
int format; 

int offset; 

char *data; 
unsigned int width; 
unsigned int height; 
int bitmap_pad; 

int bytes_per_line; 


unsigned long XGetPixel (ximage, x, y) 


XImage *ximage; 
int x; 
int y; 


int XPutPixel (ximage, x, y, pixel) 


Xlmage *ximage; 
int x; 

int y; 

unsigned long pixel; 


XImage *XSubImage (ximage, x, y, subimage_width, subimage_height) 


XImage *ximage; 
int x; 
int y; 


unsigned int subimage_width; 
unsigned int subimage_height; 


int XAddPixel(ximage, value) 


XImage *ximage; 
int value; 


int XDestroyImage (ximage) 


XImage *ximage; 


OPTIONS 
bytes_per_line 


data 
depth 
display 
format 


height 
offset 
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Specifies the number of bytes in the client image between the start of one scanline 
and the start of the next. If you pass a zero value, Xlib assumes that the scanlines 
are contiguous in memory and calculates the value of bytes_per_line itself. 


Specifies a pointer to the image data. 
Specifies the depth of the image. 
Specifies the connection to the X server. 


Specifies the format for the image. You can pass one of these constants: XYPix- 
map or ZPixmap. 


Specifies the height (in pixels) of the image. 


Specifies the number of pixels to ignore at the beginning of the scanline. This per- 
mits the rapid displaying of the image without requiring each scanline to be 
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pixel 
subimage_height 
subimage_width 
value 

visual 

width 

ximage 
bitmap_pad 


x 
y 
DESCRIPTION 
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shifted into position. 


Specifies the new pixel value. 

Specifies the height (in pixels) of the new subimage. 
Specifies the width (in pixels) of the new subimage. 
Specifies the constant value that is to be added. 
Specifies a pointer to the visual. 

Specifies the width (in pixels) of the image. 
Specifies a pointer to the image. 


Specifies the quantum of a scanline. In other words, the start of one scanline is 
separated in client memory from the start of the next scanline by an integer multi- 
ple of this many bits. You must pass one of these values: 8, 16, or 32. 


Specifies the x and y coordinates. 


The XCreateImage function allocates the memory needed for an XImage structure for the specified 


display. 


The XGetPixel function returns the specified pixel from the named image. 
The XPutPixel function overwrites the pixel in the named image with the specified pixel value. 


The XSubImage function creates a new image that is a subsection of an existing one. 


The XAddPixel function adds a constant value to every pixel in an image. 
The XDestroyImage function deallocates the memory associated with the XImage structure. 


SEE ALSO 
XPutImage(3X) 


Xlib — C Language X Interface 
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NAME 
XCreatePixmap, XFreePixmap — create and destroy pixmaps 
SYNTAX 
Pixmap XCreatePixmap (display, d, width, height, depth) 
Display *display; 
Drawable d; 
unsigned int width, height; 
unsigned int depth; 
XFreePixmap (display, pixmap) 
Display *display; 
Pixmap pixmap; 
OPTIONS 
d Specifies which screen the pixmap is created on. 
depth Specifies the depth of the pixmap. 
display Specifies the connection to the X server. 
pixmap Specifies the pixmap. 
width 
height Specifies the width and height. 
DESCRIPTION 


The XCreatePixmap function creates a pixmap of the width, height, and depth you specified. It also 
assigns the pixmap ID to it. It is valid to pass a window whose class is InputOnly to the drawable argu- 
ment. XCreatePixmap can generate BadAlloc, BadDrawable, and BadValue errors. 


The XFreePixmap function first deletes the association between the pixmap ID and the pixmap. Then, the 
X server frees the pixmap storage when no other resources reference it. The pixmap should never be refer- 
enced again. XFreePixmap can generate a BadPixmap error. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadDrawable A value for a drawable argument does not name a defined window or pixmap. 
BadPixmap A value for a pixmap argument does not name a defined pixmap. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XCreateRegion, XSetRegion, XDestroyRegion — create and destroy regions 
SYNTAX 
Region XCreateRegion () 
XSetRegion (display, gc, r) 
Display *display; 
GC gc; 
Region r; 
XDestroyRegion (7) 
Region 7; 
OPTIONS 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
r Specifies the region. 
DESCRIPTION 


The XCreateRegion function creates a new empty region. 


The XSetRegion function sets the clip mask in the graphics contexts to the specified region. Once it is set 
in the GC, the region can be destroyed. 


The XDestroyRegion function deallocates the storage associated with a specified region. 


SEE ALSO 
XEmptyRegion(3X), XIntersectRegion(3X) 
Xlib ~ C Language X Interface 
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NAME 


XCreateWindow, XCreateSimpleWindow — create windows 


SYNTAX 


Window XCreateWindow (display, parent, x, y, width, height, border_width, depth, 


class , visual, valuemask, attributes) 
Display *display; 
Window parent; 
int x, y; 
unsigned int width, height; 
unsigned int border_width; 
int depth; 
unsigned int class; 
Visual *visual 
unsigned long valuemask; 
XSetWindowAttributes *attributes; 


Window XCreateSimpleWindow (display, parent, x, y, width, height, border _width, 


border , background) 


Display *display; 
Window parent; 
int x, y; 
unsigned int width, height, border_width; 
unsigned long border; 
unsigned long background; 
OPTIONS 
attributes Attributes of the window to be set at creation time should be set in this structure. 
The valuemask should have the appropriate bits set to indicate which attributes _ 
have been set in the structure. 
background Specifies the background pixel value of the window. 
border Specifies the border pixel value of the window. 
border_width Specifies, in pixels, the width of the created window’s border. The border_width 
for an InputOnly window must be zero. Otherwise, a BadMatch error is 
retumed. 
class Specifies the created window’s class. You can pass one of these constants: Inpu- 
tOutput, InputOnly, or CopyFromParent. A class of CopyFromParent means 
the class is taken from the parent. 
depth A depth of zero for class InputOutput or ay cere, means the depth is 
taken from the parent. 
display Specifies the connection to the X server. 
parent Specifies the parent window ID. 
valuemask Specifies which window attributes are defined in the attributes argument. This 
mask is the bitwise inclusive OR of the valid attribute mask bits. If valuemask is 
zero, the attributes are ignored and are not referenced. 
visual Specifies the visual type. A visual of CopyFromParent means the visual type is 
taken from the parent. 
width 
height Specifies the width and height. 
x 
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y Specifies the x and y coordinates. 


DESCRIPTION 
The XCreateWindow function creates an unmapped subwindow for a specified parent window, returns the 
window ID of the created window, and causes the X server to generate a CreateNotify event. The created 
window is placed on top in the stacking order with respect to siblings. XCreateWindow can generate 
BadAlloc, BadColor, BadCursor, BadMatch, BadPixmap, BadValue, and BadWindow errors. 


The XCreateSimpleWindow function creates an unmapped InputOutput subwindow for a specified _ 
parent window, returns the window ID of the created window, and causes the X server to generate a 
CreateNotify event. XCreateSimpleWindow can generate BadAlloc, BadMatch, BadValue, and 


BadWindow errors. 
DIAGNOSTICS 
BadAlloc ° The server failed to allocate the requested resource or server memory. 
BadColor A value for a colormap argument does not name a defined colormap. 
BadCursor A value for a cursor argument does not name a defined cursor. 
BadMatch The values do not exist for an InputOnly window. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. 
BadPixmap A value for a pixmap argument does not name a defined pixmap. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a. defined window. 


SEE ALSO 
XChange WindowAttributes(3X), XConfigureWindow(3X), XDestroyWindow(3X), 
XMapWindow(3X), XRaiseWindow(3X), XUnmapWindow(3X) 
Xlib ~ C Language X Interface 
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NAME 
XDefineCursor, XUndefineCursor — define cursors 
SYNTAX 
XDefineCursor (display, w, cursor) 
Display *display; 
Window w; 
Cursor cursor; 
XUndefineCursor (display, w) 
Display *display; 
Window w; 
OPTIONS 
cursor Specifies the cursor that is to be displayed when the pointer is in the specified win- 
dow. You can pass None if no cursor is to be displayed. 
display Specifies the connection to the X server. 
w Specifies the window ID. 
DESCRIPTION 


The XDefineCursor function defines the mouse cursor. XDefineCursor can generate BadAlloc, BadCur- 
sor, and BadWindow errors. 


The XUndefineCursor undoes the effect of a previous XDefineCursor for this window. 
XUndefineCursor can generate a BadWindow error. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadCursor A value for a cursor argument does not name a defined cursor. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XCreateFontCursor(3X), XRecolorCursor(3X) 
Xlib — C Language X Interface 
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NAME 
XDestroy Window, XDestroySubwindows — destroy windows 
SYNTAX 
XDestroy Window (display, w) 
Display *display; 
Window w; 
XDestroySubwindows (display, w) 
Display *display; 
Window w; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
DESCRIPTION 


XDestroy Window (3X ) 


The XDestroyWindow function destroys the specified window as well as all of its subwindows and causes 
the X server to generate a DestroyNotify event for each window. XDestroyWindow can generate a 


BadWindow error. 


The XDestroySubwindows function destroys all inferior windows of the specified window, in bottom to 
top stacking order. It causes the X server to generate a DestroyNotify event for each window. If any 
mapped subwindows were actually destroyed, XDestroySubwindows causes the X sever to generate expo- 
sure events on the specified window. XDestroySubwindows can generate a BadWindow error. 


DIAGNOSTICS 

BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 

XChange WindowAttributes(3X), XConfigureWindow(3X),. 


XMapWindow(3X), XRaiseWindow(3X), XUnmap Window(3X) 
Xlib — C Language X Interface 
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NAME 
XDrawArc, XDrawArcs — draw arcs 
SYNTAX 
XDrawAre (display, d, gc, x, y, width, height, anglel , angle2) 
Display *display; 
Drawable d; 
GC ge; 
int x, ys 
unsigned int width, height; 
int anglel , angle2; 
XDrawArcs (display, d, gc, arcs, narcs) 
Display *display; 
Drawable d; 
GC ge; 
XArc *arcs; 
int narcs; 
OPTIONS 
anglel 
in units of degrees * 64. 
angle2 
degrees * 64. 
arcs Specifies a pointer to an array of arcs. 
d Specifies the drawable. 
display Specifies the connection to the X server. 
ge Specifies the graphics context. 
narcs Specifies the number of arcs in the array. 
width 
height Specifies the width and height. 
x 
y Specifies the x and y coordinates. 
DESCRIPTION 


XDrawArc (3X ) 


Specifies the start of the arc relative to the three o’clock position from the center, 


Specifies the path and extent of the arc relative to the start of the arc, in units of 


XDrawAre draws a single circular or elliptical arc, while XDrawArcs draws multiple circular or elliptical 
arcs. XDrawArc and XDrawArecs can generate BadDrawable, BadGC, and BadMatch errors. 


DIAGNOSTICS 
BadDrawable A value for a drawable argument does not name a defined window or pixmap. 
BadGC A value for a GContext argument does not name a defined GContext. 


BadMatch An InputOnly window is used as a drawable. 


BadMatch 


SEE ALSO 


some other way required by the request. 


XDrawLine(3X), XDrawPoint(3X), XDrawRectangle(3X) 
Xlib — C Language X Interface 
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Some argument or pair of arguments has the correct type and range but fails to match in 
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XDrawImageString, XDrawImageString16 — draw image text 
SYNTAX 
XDrawimageString (display, d, gc, x, y, string, length) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
char *string; 
int length; 
XDrawImageString16 (display, d, gc, x,y, string, length) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
XChar2b *string; 
int length; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
ge Specifies the graphics context. 
length Specifies the number of characters in the string argument. 
string Specifies the character string. 
x 
y Specifies the x and y coordinates. 
DESCRIPTION 


The XDrawimageString and XDrawImageString16 functions draw 8-bit and 16-bit image text characters 
in the specified drawable. These functions also modify both the foreground and background pixels in the 
characters. XDrawImageString and XDrawImageString16 can generate BadDrawable, BadGC, and 


BadMatch errors. 
DIAGNOSTICS 


BadDrawable A value for a drawable argument does not name a defined window or pixmap. 


BadGC A value for a GContext argument does not name a defined GContext. 


BadMatch An InputOnly window is used as a drawable. 


BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. 


SEE ALSO 
XDrawString(3X), XDrawText(3X) 
Xlib — C Language X Interface 


1 September 1988 INTEGRATED SOLUTIONS 


XDrawLine (3X ) X Window System Reference Manual XDrawLine (3X) 
NAME 
XDrawLine, XDrawLines, XDrawSegments — draw lines and polygons 
SYNTAX 
XDrawLine (display, d, gc, xl, yl, x2, y2) 
Display *display; 
Drawable d; 
GC gc; 
int x1, yl , x2, y2; 
XDrawLines (display, d, gc, points, npoints, mode) 
Display *display; 
Drawable d; 
GC gc; 
XPoint *points; 
int npoints; 
int mode ; 
XDrawSegments (display, d, gc, segments, nsegments) 
Display *display; 
Drawable d; 
GC ge; 
XSegment *segments; 
int nsegments; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
mode Specifies the coordinate mode. CoordModeOrigin treats a coordinate as related 
to the origin, while CoordModePrevious treats all coordinates after the first as 
relative to the previous point. 
npoints Specifies the number of points in the array. 
nsegments Specifies the number of segments in the array. 
points Specifies a pointer to an array of points. 
segments Specifies a pointer to an array of segments. 
xl 
yl 
x2 
y2 Specifies the points used to connect the line. Thus, XDrawLine draws a line con- 
necting point x1, y1 to point x2, y2. 
DESCRIPTION 


The XDrawLine function draws a single line between two points in the specified drawable. 
The XDrawLines function draws multiple lines in the specified drawable. 
The XDrawSegments function draws multiple, but not necessarily connected, lines in the specified draw- 


able. 


XDrawLine, XDrawLines, and XDrawSegments can generate BadDrawable, BadGC, and BadMatch 


errors. 
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XDrawLines can also generate a BadValue error. 


DIAGNOSTICS 
BadDrawable A value for a drawable argument does not name a defined window or pixmap. 


BadGC A value for a GContext argument does not name a defined GContext. 

BadMatch An InputOnly window is used as a drawable. 

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
XDrawArc(3X), XDrawPoint(3X), XDrawRectangle(3X) 
Xlib — C Language X Interface 
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NAME 
XDrawPoint, XDrawPoints — draw points 
SYNTAX 
XDrawPoint (display, d, gc, x, y) 
Display *display; 
Drawable d; 
GC ge; 
int x, y3 
XDrawPoints (display, d, gc, points, npoints, mode) 
Display *display; 
Drawable d; 
GC gc; 
XPoint *points; 
int npoints; 
int mode ; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
ge Specifies the graphics context. 
mode Specifies the coordinate mode. CoordModeOrigin treats a coordinate as related 
to the origin, while CoordModePrevious treats all coordinates after the first as 
relative to the previous point. 
npoints Specifies the number of points in the array. 
points Specifies a pointer to an array of points. 
x 
y Specifies the x and y coordinates where you want the point drawn. 
DESCRIPTION 


The XDrawPoint function uses the foreground pixel and function components of the graphics context to 
draw a single point into the specified drawable, while XDrawPoints draws multiple points into the 
specified drawable. These functions are not affected by the tile or stipple in the graphics context. 


XDrawPoint can generate BadDrawable, BadGC, and BadMatch errors. XDrawPoint can generate 
BadDrawable, BadGC, BadMatch, and BadValue errors. 


DIAGNOSTICS 

BadDrawable A value for a drawable argument does not name a defined window or pixmap. 

BadGC A value for a GContext argument does not name a defined GContext. 

BadMatch An InputOnly window is used as a drawable. 

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XDrawArc(3X), XDrawLine(3X), XDrawRectangle(3X) 
Xlib ~- C Language X Interface 


1 September 1988 INTEGRATED SOLUTIONS 1 
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NAME 
XDrawRectangle, XDrawRectangles — draw rectangles 
SYNTAX 
XDrawRectangle (display, d, gc, x, y, width, height) 
Display *display; 
Drawable d; 
GC ge; 
int x, y; 


unsigned int width, height; 
XDrawRectangles (display, d, gc, rectangles, nrectangles) 


Display *display; 
Drawable d; 
GC gc; 
XRectangle rectangles{]; 
int nrectangles; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
nrectangles Specifies the number of rectangles in the array. 
rectangles Specifies a pointer to an array of rectangles. 
width 
height Specifies the width and height that define the outline of the rectangle. 
x 
y Specifies the x and y coordinates that define the upper-left corner of the rectangle. 
DESCRIPTION 


The XDrawRectangle and XDrawRectangles functions draw the outlines of the specified rectangle or 
rectangles as if a five-point PolyLine were specified for each rectangle: 


[x,y,] [x+width,y] [x+width,y+height] [x,y+height] [x,y] XDrawRectangle and XDrawRectan- 
gles can generate BadDrawable, BadGC, and BadMatch errors. 


DIAGNOSTICS 
BadDrawable A value for a drawable argument does not name a defined window or pixmap. 
BadGC A value for a GContext argument does not name a defined GContext. 
BadMatch An InputOnly window is used as a drawable. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 
SEE ALSO 


XDrawArc(3X), XDrawLine(3X), XDrawPoint(3X) 
Xlib — C Language X Interface 
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NAME ; 
XDrawString, XDrawString16 — draw text characters 
SYNTAX 
XDrawString (display, d, gc, x, y, string, length) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
char *string; 
int length; 
XDrawString16 (display, d, gc, x, y, string, length) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
XChar2b *string; 
int length; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
length Specifies the number of characters in the string argument. 
string Specifies the character string. 
x 
y Specifies the x and y coordinates. 
DESCRIPTION 


XDrawString (3X ) 


The XDrawString and XDrawString16 functions draw 8-bit and 16-bit text characters in the specified 
drawable. XDrawString and XDrawString16 can generate BadDrawable, BadFont, BadGC, and Bad- 


Match errors. 
DIAGNOSTICS 


BadDrawable A value for a drawable argument does not name a defined window or pixmap. 


BadGC A value for a GContext argument does not name a defined GContext. 
BadMatch An InputOnly window is used as a drawable. 


BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 


some other way required by the request. 


SEE ALSO 
XDrawImageString(3X), XDrawText(3X) 
Xlib — C Language X Interface 
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XDrawText (3X ) X Version 11 
NAME : 
XDrawText, XDrawText16 — draw polytext text 
SYNTAX 
XDrawText (display, d, gc, x, y, items, nitems) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
XTextltem *items; 
int nitems; 
XDrawText16 (display, d, gc, x, y, items, nitems) 
Display *display; 
Drawable d; 
GC ge; 
int x, y; 
XTextltem16 *items; 
int nitems; 
OPTIONS 
d Specifies the drawable. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
items Specifies a pointer to an array of text items. 
nitems Specifies the number of text items in the array. 
x 
y Specify the x and y coordinates. 
DESCRIPTION 


XDrawText (3X ) 


The XDrawText and XDrawText16 functions draw 8-bit and 16-bit polytext characters in the specified 
drawable. XDrawText and XDrawText16 can generate BadDrawable, BadFont, BadGC, and Bad- 


Match errors. 


DIAGNOSTICS 
BadDrawable 


BadFont 

BadGC 

BadMatch 
SEE ALSO 


A value for a Drawable argument does not name a defined Window or Pixmap. 


A value for a Font or GContext argument does not name a defined Font. 


A value for a GContext argument does not name a defined GContext. 


An InputOnly window is used as a Drawable. 


XDrawImageString(3X), XDrawString(3X) 
Xlib — C Language X Interface 
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NAME 
XEmptyRegion, XEqualRegion — determine if regions are empty or equal 
SYNTAX 
int XEmptyRegion(r) 
Region 7; 
int XEqualRegion(r/, r2) 
Region rl, 72; 
OPTIONS 
r Specifies the region. 
rl 
r2 Specify the two regions. 
DESCRIPTION 
The XEmptyRegion function returns nonzero if the specified region is empty. 
The XEqualRegion function returns nonzero if two regions have the same offset, size, and shape. 
SEE ALSO 


XCreateRegion(3X), XIntersectRegion(3X) 
Xlib — C Language X Interface 
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NAME 
XFillRectangle, XFillRectangles, XFillPolygon, XFillArc, XFillArcs — fill rectangles, polygons, or arcs 
SYNTAX 
XFillRectangle (display, d, gc, x, y, width, height) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 


unsigned int width, height; 
XFillRectangles (display, d, gc, rectangles, nrectangles) 


Display *display; 
Drawable d; 
GC gc; 
XRectangle *rectangles; 
int nrectangles; 
XFillPolygon( display, d, gc, points, npoints, shape, mode) 
Display *display; 
Drawable d; 
GC gc; 
XPoint *points; 
int npoints; 
int shape; 
int mode; 
XFillArc (display, d, gc, x, y, width, height, anglel , angle2) 
Display *display; 
Drawable d; 
GC gc; 
int x, y; 
unsigned int width, height; 
int anglel , angle2; 
XFillArcs (display, d, gc, arcs, narcs) 
Display *display; 
Drawable d; 
GC ge; 
XArc *arcs; 
int narcs; 
OPTIONS 
anglel Specifies the start of the arc relative to the three o’clock position from the center, 
in units of degrees * 64. 
angle2 Specifies the path and extent of the arc relative to the start of the arc, in units of 
degrees * 64. 
arcs Specifies a pointer to an array of arcs. 
d Specifies the drawable. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
mode Specifies the coordinate mode. CoordModeOrigin treats a coordinate as related 


to the origin, while CoordModePrevious treats all coordinates after the first as 
relative to the previous point. 
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XFillRectangle (3X) 


narcs 
npoints 
nrectangles 
points 
rectangles 


shape 


width 

height 

x 

y 
DESCRIPTION 


X Window System Reference Manual XFillRectangle (3X ) 


Specifies the number of arcs in the array. 

Specifies the number of points in the array. 

Specifies the number of rectangles in the array. 

Specifies a pointer to an array of points. 

Specifies a pointer to an array of rectangles. 

Specifies an argument that helps the server to improve performance. You can pass 


one of these constants: Complex, Convex, or Nonconvex. 


Specifies the width and height. 


Specifies the x and y coordinates. 


The XFillRectangle and XFillRectangles functions fill the specified rectangle or rectangles as if a four- 
point XFillPolygon were specified for each rectangle: 


[x,y] [x+width,y] [x+width,y+height] [x,y+height] 
XFillRectangle and XFillRectangles can generate BadDrawable, BadGC, and BadMatch errors. 


The XFillPolygon function fills a polygon area in the specified drawable. XFillRectangle can generate 
BadDrawable, BadGC, BadMatch, and BadValue errors. 


The XFillArc function fills a single arc in the specified drawable, while XFillArcs fills multiple arcs in the 
specified drawable. XFillArc and XFillArcs can generate BadDrawable, BadGC, and BadMatch errors. 


DIAGNOSTICS 
BadDrawable 


BadGC 
BadMatch 
BadMatch 


BadValue 


SEE ALSO 


A value for a drawable argument does not name a defined window or pixmap. 
A value for a GContext argument does not name a defined GContext. 
An InputOnly window is used as a drawable. 


Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 


Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


XDrawArc(3X), XDrawRectangle(3X) 
Xlib — C Language X Interface 
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XFlush (3X) X Window System Reference Manual XFlush (3X) 


NAME 
XFlush, XSync, XEventsQueued, XPending, XNextEvent, XPeekEvent — basic error handling 


SYNTAX 


XFlush (display) 
Display *display; 


XSync( display, discard) 
Display *display; 
int discard; 


int XEventQueued (display, more) 
Display *display; 
int mode; 
int XPending (display) 
Display *display; 
XNextEvent (display, event_return) 
Display *display; 
XEvent *event_return; 
XPeekEvent (display, event_return) 
Display *display; 
XEvent *event_return; 


OPTIONS 
discard Specifies whether XSync discards all events on the event queue. You can pass the 
value 0 or 1. 
display. Specifies the connection to the X server. 
event_return Copies the event’s associated structure into this client-supplied structure. 
mode Specifies the mode. You can specify one of these constants: QueuedAlready, 
QueuedAfterFlush, QueuedAfterReading. 
DESCRIPTION 


The XFlush function flushes the output buffer. 


The XSync function flushes the output buffer and then waits until all requests have been received and pro- 
cessed by the X server. 


If mode is QueuedAlready, XEventsQueued returns the number of events already in the event queue (and 
never performs a system call). If mode is QueuedAfterFlush, it returns the number of events already in 
the queue, if it is nonzero. If there are no events in the queue, it flushes the output buffer, attempts to read 
more events out of the application’s connection, and returns the number read. If mode is QueuedAfter- 
Reading, it returns the number of events already in the queue, if it is nonzero. If there are no events in the 
queue, it attempts to read more events out of the application’s connection without flushing the output buffer 
and returns the number read. 


The XPending function returns the number of events that have been received from the X server but have 
not been removed from the event queue. 


The XNextEvent function copies the first event from the event queue into the specified XEvent structure 
and then removes it from the queue. 


The XPeekEvent function returns the first event from the event queue, but it does not remove the event 
from the queue. 


SEE ALSO 


XIfEvent(3X), XPutBackEvent(3X) 
Xlib — C Language X Interface 
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XFree (3X ) X Window System Reference Manual 
NAME 
XFree, XNoOp - free client data 
SYNTAX 
XFree (data) 
char *data; 
XNoOp (display) 
Display *display; 
OPTIONS 
display Specifies the connection to the X server. 
data Specifies a pointer to the data that is to be freed. 
DESCRIPTION 


The XFree function is a general purpose Xlib routine that frees the specified data. 


XFree (3X ) 


The XNoOp function essentially sends a NoOperation request to the X server, thereby exercising the con- 


nection. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XGetDefault — get X program defaults 
SYNTAX 
char *XGetDefault (display, program, option) 
Display *display; 
char *program; 
char *option; 
OPTIONS 
display Specifies the connection to the X server. 
option Specifies the option name. 
program Specifies the program name for the Xlib defaults. You must pass the program 
name in with the program argument (usually argv[0]). 
DESCRIPTION 
The XGetDefault function finds out the fonts, colors, and other environment defaults favored by a particu- 
lar user for the specified program. 
SEE ALSO 
XrmGetSearchList(3X) 


Xlib — C Language X Interface 
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NAME 
XGetVisuallInfo, XMatchVisualInfo — obtain visual information 


SYNTAX 
XVisualInfo *XGetVisuallnfo( display, vinfo_mask, vinfo_template, nitems_return) 
Display *display; 
long vinfo_mask; 
XVisuallnfo *vinfo_template; 
int *nitems_return; 


Status XMatchVisuallInfo( display, screen, depth, class, vinfo_return) 


Display *display; 
int screen; 
int depth; 
int class; 
XVisuallnfo *vinfo_return; 
OPTIONS 
class Specifies the class of the screen. 
depth Specifies the depth of the screen. 
display Specifies the connection to the X server. 
nitems_return Returns the number of matching visual structures. 
screen Specifies the screen. 
vinfo_mask Specifies the visual mask value. 
vinfo_return Returns the match visual information. 
vinfo_template Specifies the visual attributes that are to be used in matching the visual structures. 
DESCRIPTION 


The XGetVisualInfo function returns a list of visual structures that match the attributes specified by the 
template argument. If no visual structures match the template using the specified vinfo_mask, XGet- 
VisualInfo returns a NULL. 

The XMatchVisualinfo function obtains the visual information that matches the specified depth and class 
of the screen. 


SEE ALSO 
Xlib — C Language X Interface 
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XGetWindowAttributes, XGetGeometry — get current window attribute or geometry 


Status XGetWindowA ttributes (display, w, window_attributes_return) 


XGetWindowAttributes (3X ) 
NAME 
SYNTAX 
Display *display; 
Window w; 


XWindowAttributes *window_attributes_return; 


Status XGetGeometry (display, d, root_return, x_return, y_return, width_return, 
height_return, border_width_return, depth_return) 


Display *display; 
Drawable d; 
Window *root_return; 


int *x_return, *y_return; 

unsigned int *width_return, *height_return; 
unsigned int *border_width_return; 
unsigned int *depth_return; 


OPTIONS 
border_width_return 


d 
depth_return 
display 
root_return 
w 


width_return 
height_return 


window_attributes_return 


x_return 


y_return 


DESCRIPTION 


Retums the border width in pixels. 

Specifies the drawable. 

Returns the depth of the pixmap (bits per pixel for the object). 
Specifies the connection to the X server. 

Retums the root window ID for the specified window. 
Specifies the window ID. 


Returns the drawable’s dimensions (width and height). 


Returns the specified window’s attributes in the XWindowAttributes struc- 
ture. 


Returns the x and y coordinates of the drawable. These coordinates define 
the location of the drawable. For a window, these coordinates specify the 
upper-left outer corner relative to its parent’s origin. For pixmaps, these 
coordinates are always zero. 


The XGetWindowAttributes function returns the current attributes for the specified window to an XWin- 


dowAttributes structure. 


The XGetGeometry function returns the root ID and the current geometry of the drawable. XGet- 
Geometry can generate a BadDrawable error. 


DIAGNOSTICS 


BadDrawable A value for a drawable argument does not name a defined window or pixmap. 


BadWindow A value for a window argument does not name a defined window. 


SEE ALSO 


XQueryPointer(3X), XQueryTree(3X) 
Xlib — C Language X Interface 
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NAME 


XGetWindowProperty, XListProperties, XChangeProperty, XRotateWindowProperties, XDeleteProperty — 


obtain and change window properties 


SYNTAX 
int XGetWindowProperty (display, w, property, long_offset, long_length, delete, req_type, 

actual_type_return, actual_format_return, nitems_return, bytes_after_return, 
prop_return) 

Display *display; 

Window w; 

Atom property; 

long long_offset, long_length; 

Bool delete; 

Atom req_type; 

Atom *actual_type_return; 

int *actual_format_return; 

unsigned long *nitems_return; 

unsigned long *bytes_after_return; 

unsigned char **prop_return; 


Atom *XListProperties (display, w, num_prop_return) 
Display *display; 
Window w; 
int *num_prop_return; 


XChangeProperty (display, w, property, type, format, mode , data, nelements) 
Display *display; 
Window w; 
Atom property, type; 
int format; 
int mode; 
unsigned char *data; 
int nelements ; 


XRotateWindowProperties (display, w, properties, num_prop, npositions) 
Display *display; 
Window w; 
Atom properties (]; 
int num_prop; 
int npositions; 
XDeleteProperty (display, w, property) 
Display *display; 
Window w; 
Atom property; 


OPTIONS 
actual_format_return Returns the actual format of the property. 


actual type_return _Returns the atom identifier that defines the actual type of the property. 


bytes_after_return Returns the number of bytes remaining. This is the number of bytes remaining to 


be read in the property if a partial read was performed. 
data . Specifies the property data. 


delete Specifies a boolean value that determines whether the property is deleted from the 


window. You can pass one of these constants: True or False. 
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nitems_return 


num_prop 


num_prop_return 
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display Specifies the connection to the X server. 

format Specifies whether the data should be viewed as a list of 8-bit, 16-bit, or 32-bit 
quantities. This information allows the X server to correctly perform byte-swap 
operations as necessary. If the format is 16-bit or 32-bit, you must explicitly cast 
your data pointer to a (char *) in the call to XChangeProperty. Possible values 
are 8, 16, and 32. . 

long_length Specifies the length in 32-bit multiples of the data to be retrieved. 

long_offset Specifies the offset in the specified property (in 32-bit quantities) where data will 
be retrieved. 

mode Specifies the mode of the operation. You can pass one of these constants: Prop- 
ModeReplace, PropModePrepend, or PropModeA ppend. 

nelements Specifies the number of elements of the specified data format (8-bit, 16-bit, or 32- 


bit). 


Returns the actual number of 8-bit, 16-bit, or 32-bit items stored in the 
prop_return data. 


Specifies the length of the properties array. 
Returns the length of the properties array. 


npositions Specifies the rotation amount. 

prop_return Returns a pointer to the data in the specified format. 

property Specifies the property atom. 

properties Specifies the array of properties that are to be rotated. 

req_type Specifies the atom identifier associated with the property type. You can also pass 
AnyPropertyType. 

type Specifies the type of the property. The X server does not interpret the type but 
simply passes it back to an application that later calls XGetProperty. 

Ww Specifies the window ID. 

DESCRIPTION 


The XGetWindowProperty function returns the actual type of the property; the actual format of the pro- 
perty; the number of 8-bit, 16-bit, or 32-bit items transferred; the number of bytes remaining to be read in 
the property; and a pointer to the data actually returned. XGetWindowProperty can generate BadAtom, 
BadValue, and BadWindow errors. 


The XListProperties function returns a pointer to an array of atom properties that are defined for the 
specified window. XListProperties can generate a BadWindow error. 


The XChangeProperty function alters the property for the specified window and causes the X server to 
generate a PropertyNotify event on that window. XChangeProperty can generate BadAlloc, BadAtom, 
BadMatch, BadValue, and BadWindow errors. 


The XRotateWindowProperties function allows you to rotate properties in the properties array and causes 
the X server to generate a PropertyNotify event. XRotateWindowProperties can generate BadAtom, 
BadMatch, and BadWindow errors. 


The XDeleteProperty function deletes the specified property only if the property was defined on the 
specified window. XDeleteProperty causes the X server to generate a PropertyNotify event on the win- 
dow, unless the property does not exist. XDeleteProperty can generate BadAtom and BadWindow 
errors. 
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DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadAtom A value for an atom argument does not name a defined atom. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XInternAtom(3X) 
Xlib — C Language X Interface 
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NAME 


XGrabButton, XUngrabButton — manipulate the pointer 


SYNTAX 


XGrabButton( display, button_grab, modifiers, grab_window, owner_events, event_mask, 


pointer_mode, keyboard_mode , confine_to, cursor) 
Display *display; 
unsigned int button_grab; 
unsigned int modifiers; 
Window grab_window; 
Bool owner_events; 
unsigned int event_mask; 
int pointer_mode, keyboard_mode; 
Window confine_to; 
Cursor cursor; 


XUngrabButton (display, button_ungrab, modifiers, ungrab_window) 


Display *display; 

unsigned int button_ungrab; 
unsigned int modifiers; 
Window ungrab_window; 


OPTIONS 

button_grab Specifies the pointer button that is to be grabbed when the specified modifier keys 
are down. 

button_ungrab Specifies the pointer button that is to be released in combination with the modifier 
keys. 

confine_to Specifies the window to confine the pointer in or None if it is not to be confined. 

cursor Specifies the cursor that is to be displayed during the grab. 

display Specifies the connection to the X server. 

event_mask Specifies which pointer events are reported to the client. They can be the bitwise 
inclusive OR of these pointer event mask bits: ButtonPressMask, Button- 
ReleaseMask, EnterWindowMask, LeaveWindowMask, PointerMotionMask, 
Pointer MotionHintMask, ButtonlMotionMask, Button2MotionMask, 
Button3MotionMask, Button4MotionMask, ButtonSMotionMask, ButtonMo- 
tionMask, KeyMapStateMask. 

grab_window Specifies the window ID of the window you want to grab. 

keyboard_mode Controls further processing of keyboard events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 

modifiers Specifies the set of keymasks. This mask is the bitwise inclusive OR of these key- 
mask bits: ShiftMask, LockMask, ControlMask, ModiMask, Mod2Mask, 
Mod3Mask, Mod4Mask, Mod5Mask. 

owner events Specifies if the pointer events are to be reported normally (pass True ) or with 
respect to the grab window if selected by the event mask (pass False ). 

pointer_mode Controls further processing of pointer events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 

ungrab_window Specifies the window ID of the window you want to ungrab. 

DESCRIPTION 


The XGrabButton function establishes a passive grab. XGrabButton can generate BadAlloc, BadCur- 
sor, BadValue, and Bad Window errors. 
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The XUngrabButton function releases the passive button/key combination on the specified window if it 
was grabbed by this client. XUngrabButton can generate a BadWindow error. 


DIAGNOSTICS 
BadAccess A client attempted to grab a key/button combination already grabbed by another client. 


BadCursor A value for a Cursor argument does not name a defined Cursor. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a Window argument does not name a defined Window. 


SEE ALSO , 
XAllowEvents(3X), XGrabPointer(3X), XGrabKey(3X), XGrabKeyboard(3X), 
Xlib — C Language X Interface 
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NAME 


X Window System Reference Manual XGrabKey (3X) 


XGrabKey, XUngrabKey — manipulate the keyboard 


SYNTAX 


XGrabKey (display, keycode , modifiers, grab_window, owner_events, pointer_mode, 
keyboard_mode) 


Display *display; 


int keycode ; 


unsigned int modifiers; 
Window grab_window; 


Bool owner_events; 


int pointer_mode, keyboard_mode; 


XUngrabKey (display, keycode , modifiers, ungrab_window) 


Display *display; 


int keycode ; 


unsigned int modifiers; 
Window ungrab_window; 


OPTIONS 
display 


grab_window 
keycode 
keyboard_mode 


modifiers 
owner_events 
pointer_mode 
ungrab_window 


DESCRIPTION 


Specifies the connection to the X server. 
Specifies the window ID of the window associated with the keys you want to grab. 
Specifies the keycode. 


Controls further processing of keyboard events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 


Specifies the set of keymasks. This mask is the bitwise inclusive OR of these key- 
mask bits: ShiftMask, LockMask, Control[Mask, ModlMask, Mod2Mask, 
Mod3Mask, Mod4Mask, Mod5Mask. 


Specifies a boolean value of either True or False. 


Controls further processing of pointer events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 


Specifies the window ID of the window associated with the keys you want to 
ungrab. 


The XGrabKey function establishes a passive grab on the keyboard. XGrabKey can generate BadAc- 
cess, Bad Value, and Bad Window errors. 


The XUngrabKey function releases the key combination on the specuied window if it was grabbed by this 
client. XUngrabKey can generate a BadWindow error. 


DIAGNOSTICS 
BadAccess 


BadValue 


BadWindow 
SEE ALSO 


A client attempted to grab a key/button combination already grabbed by another client. 


Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


A value for a window argument does not name a defined window. 


XAllowAccess(3X), XGrabButton(3X), XGrabKeyboard(3X), XGrabPointer(3X) 
Xlib — C Language X Interface 
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NAME 
XGrabKeyboard, XUngrabKeyboard — manipulate the keyboard 
SYNTAX 
int XGrabKeyboard (display, grab_window, owner_events, pointer_mode , keyboard_mode , time) 


Display *display; 

Window grab_window; 

Bool owner_events; 

int pointer_mode , keyboard_mode; 


Time time; 
XUngrabKeyboard (display, time) 
Display *display; 
Time time; 
OPTIONS 
display Specifies the connection to the X server. 
grab_window Specifies the window ID of the window associated with the keyboard you want to 
grab. 
keyboard_mode Controls further processing of keyboard events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 
owner_events Specifies a boolean value of either True or False. 
pointer_mode Controls further processing of pointer events. You can pass.one of these con- 
stants: GrabModeSync or GrabModeAsync. 
time Specifies the time. You can pass either a timestamp, expressed in milliseconds, or 
CurrentTime. 
DESCRIPTION 


The XGrabKeyboard function actively grabs control of the main keyboard and generates FocusIn and 
FocusOut events. XGrabKeyboard can generate Bad Value and BadWindow errors. 


The XUngrabKeyboard function releases the keyboard and any queued events if this client has it actively 
grabbed from either XGrabKeyboard or XGrabKey. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XAllowEvents(3X), XGrabButton(3X), XGrabKey(3X), XGrabPointer(3X) 
Xlib — C Language X Interface 
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NAME 
XGrabPointer, XUngrabPointer, XChangeActivePointerGrab — manipulate the pointer 


SYNTAX 
int XGrabPointer (display, grab_window, owner_events, event_mask, pointer_mode, 
keyboard_mode, confine_to, cursor, time) 
Display *display; 
Window grab_window; 
Bool owner_events; 
unsigned int event_mask; 
int pointer_mode, keyboard_mode; 
Window confine_to; 
Cursor cursor; 
Time time ; 


XUngrabPointer (display, time) 
Display *display; 
Time time; 
XChangeActivePointerGrab (display, event_mask, cursor, time) 
Display *display; 
unsigned int event_mask; 
Cursor cursor; 


Time time; 
OPTIONS 

confine_to Specifies the window to confine the pointer in or None if it is not to be confined. 

cursor Specifies the cursor that is to be displayed during the grab. 

display Specifies the connection to the X server. 

event_mask Specifies which pointer events are reported to the client. They can be the bitwise 
inclusive OR of these pointer event mask bits: ButtonPressMask, Button- 
ReleaseMask, EnterWindowMask, LeaveWindowMask, PointerMotionMask, 
Pointer MotionHintMask, ButtonlMotionMask, Button2MotionMask, 
Button3MotionMask, Button4MotionMask, ButtonSMotionMask, ButtonMo- 
tionMask, KeyMapStateMask. 

grab_window Specifies the window ID of the window relative to which events are reported 
while it is grabbed. 

keyboard_mode Controls further processing of keyboard events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 

owner_events Specifies if the pointer events are to be reported normally (pass True) or with 
respect to the grab window if selected by the event mask (pass False). 

pointer_mode Controls further processing of pointer events. You can pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 

time Specifies the time. You can pass either a timestamp, expressed in milliseconds, or 
CurrentTime. 

DESCRIPTION 


The XGrabPointer function actively grabs control of the pointer and returns GrabSuccess if the grab was 
successful. XGrabPointer can generate BadCursor, BadValue, and BadWindow errors. 


The XUngrabPointer function releases the pointer and any queued events, if this client has actively 
grabbed the pointer from XGrabPointer, XGrabButton, or from a normal button press. 
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The XChangeActivePointerGrab function changes the specified dynamic parameters if the pointer is 
actively grabbed by the client and if the specified time is no earlier than the last-pointer-grab time and no 
later than the current X server time. XChangeActivePointerGrab can generate a BadCursor error. 


DIAGNOSTICS 
BadCursor A value for a cursor argument does not name a defined cursor. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XAllowEvents(3X), XGrabButton(3X), XGrabKey(3X), XGrabKeyboard(3X) 
Xlib — C Language X Interface 
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NAME 
XGrabServer, XUngrabServer — manipulate the keyboard 


SYNTAX 
XGrabServer (display) 
Display *display; 
XUngrabServer (display) 
Display *display; 
OPTIONS 
display Specifies the connection to the X server. 


DESCRIPTION 


XGrabServer (3X ) 


The XGrabServer function disables processing of requests and close-downs on all other connections than 
the one this request arrived on. It is recommended that you not grab the X server any more than is abso- 


lutely necessary. 


The XUngrabServer function restarts processing of requests and close-downs on other connections. You 


should avoid grabbing the server as much as possible. 
SEE ALSO 


XGrabButton(3X), XGrabKey(3X), XGrabKeyboard(3X), XGrabPointer(3X) 


Xlib ~ C Language X Interface 
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NAME 
XIfEvent, XCheckIfEvent, XPeekIfEvent — check the event queue 
SYNTAX 
XIfEvent (display, event_return, predicate, arg) 
Display *display; 
XEvent *event_return; 
Bool (*predicate)(); 
char *arg; 
Bool XCheckIfEvent (display, event_return, predicate, arg) 
Display *display; 
XEvent *event_return; 
Bool (*predicate)(); 
Char *arg; 
XPeeklIfEvent (display, event_return, predicate, arg) 
Display *display; 
XEvent *event_return; 
Bool (*predicate )(); 
char *arg; 
OPTIONS 
arg Specifies the user-supplied argument that is to be passed to the predicate pro- 
cedure. | 
display Specifies the connection to the X server. 
event_return Copies the matched event’s associated structure into this client-supplied structure. 
predicate Specifies the procedure that is to be called to determine if the next event in the 
queue matches the one specified by the event argument. 
DESCRIPTION 


The XIfEvent function checks the event queue for the specified event. If the events match as determined 
by your predicate procedure, XIfEvent removes the event from the queue and, when it returns, copies the 


structure into the client-supplied XEvent structure. 


The XCheckIfEvent function checks the event queue for the specified event. 


The XPeekIfEvent function returns only when the specified predicate procedure returns a nonzero (true) 


for the next event in the queue that matches the specified event. 


SEE ALSO 
XFlush(3X), XPutBackEvent(3X) 
Xlib — C Language X Interface 
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NAME 
XInstallColormap, XUninstallColormap, XListInstalledColormaps — install colormaps 


SYNTAX 
XInstallColormap (display, cmap) 
Display *display; 
Colormap cmap; 


XUninstallColormap( display, cmap) 
Display *display; 
Colormap cmap; 


Colormap *XListInstalledColormaps (display, w, num_return) 


Display *display; 
Window w; 
int *num_return; 
OPTIONS 
cmap Specifies the colormap ID. 
display Specifies the connection to the X server. 
num_return Returns the list of currently installed colormaps. 
w Specifies the window ID. 
DESCRIPTION 


The XInstallColormap function installs the specified colormap for its associated screen. XInstallColor- 
map can generate a BadColor error. 


The XUninstallColormap function removes the specified colormap from the required list for its screen. 
XUninstallColormap can generate a BadColor error. 


The XListInstalledColormaps function returns a list of the currently installed colormaps for the screen of 
the specified window. XListInstalledColormaps can generate a Bad Window error. 


DIAGNOSTICS 
BadColor A value for a colormap argument does not name a defined colormap. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XInternAtom, XGetAtomName -— create and return atom names 


SYNTAX 
Atom XInternAtom (display, atom_name, only_if exists) 
Display *display; 
char *atom_name; 
Bool only_if_exists; 


char *XGetAtomName (display, atom) 


Display *display; 
Atom atom; 
OPTIONS 
atom Specifies the atom associated with the string name you want returned. 
atom_name Specifies the name associated with the atom you want returned. 
display - Specifies the connection to the X server. 
only_if_exists Specifies a boolean value that indicates whether XInternAtom creates the atom. 
You can pass either True or False. 
DESCRIPTION 


The XInternAtom function returns the atom identifier associated with the string you passed to the 
atom_name argument. XInternAtom can generate BadAlloc and BadValue errors. 


The XGetAtomName function returns the name associated with the atom identifier you passed to the atom 
argument. You previously obtained the atom identifier by calling XInternAtom. XGetAtomName can 
generate a-BadAtom error. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadAtom A value for an Atom argument does not name.a defined Atom. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
. specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 
SEE ALSO 
XGetWindowProperty(3X) 
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NAME 
XIntersectRegion, XUnionRegion, XUnionRectWithRegion, XSubtractRegion, XXorRegion, XOffsetRe- 
gion, XShrinkRegion, XPointInRegion, XRectInRegion — region arithmetic 


SYNTAX 
XIntersectRegion (sra, srb, dr) 
Region sra, srb, dr; 


XUnionRegion(sra, srb, dr) 
Region sra, srb, dr; 
XUnionRectWithRegion (rectangle, src_region, dest_region) 
Rectangle *rectangle; 
Region src_region; 
Region dest_region; 
XSubtractRegion (sra, srb, dr) 
Region sra, srb, dr; 


XXorRegion(sra, srb, dr) 
Region sra, srb, dr; 


XOffsetRegion(r, dx, dy) 
Region r; 
int dx, dy; 
XShrinkRegion(r, dx, dy) 
Region 7; 
int dx, dy; 
int XPointInRegion(r, x, y) 
Region r; 
int x, y; 
int XRectInRegion (7, x, y, width, height) 
Region r; 
int x, y; 
unsigned int width, height; 
OPTIONS 
dr Stores the result of the computation. 
dest_region Specifies the destination region. 
dx 
dy Specifies the x and y coordinates. 
r Specifies the region. 
rectangle Specifies the rectangle. 
sra 
srb Specifies the two regions with which you want to perform the computation. 
src_region Specifies the source region to be used. 
width 
height Specifies the width and height. 
x 
y . Specifies the x and y coordinates. 
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DESCRIPTION 
The XIntersectRegion function computes the intersection of two regions. 


The XUnionRegion function computes the union of two regions. 


The XUnionRectWithRegion function creates the destination region from a union of the specified rectan- 
gle and the specified source region. 


The XSubtractRegion function subtracts two regions. 

The XXorRegion function calculates the difference between the union and intersection of two regions. 
The XOffsetRegion function moves the specified region by a specified amount. 

The XShrinkRegion function reduces the specified region by a specified amount. 

The XPointInRegion function returns nonzero if the point x, y is contained in the region r. 


The XRectInRegion function returns RectangleIn if the rectangle is entirely in the specified region, Rec- 
tangleOut if the rectangle is entirely out of the specified region, and RectanglePart if the rectangle is par- 
tially in the specified region. 

SEE ALSO 
XCreateRegion(3X), XEmptyRegion(3X), 
Xlib — C Language X Interface 
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NAME 
XListFonts, XFreeFontNames — obtain and free font names 
SYNTAX 
char **XListFonts (display, pattern, maxnames, actual_count_return) 
Display * display; 
char * pattern; 
int maxnames; 
int *actual_count_return, 
XFreeFontNames (list) 
char */ist(]; 
OPTIONS 
actual_count_return Returns the actual number of font names. 
display Specifies the connection to the X server. 
list Specifies the array of strings you want to free. 
maxnames Specifies the maximum number of names that are to be in the returned list. 
pattern Specifies the null-terminated string associated with the font names that you want 


retumed. You can specify any string, an asterisk ‘‘*’’, or a question mark ‘‘?’’, 
The asterisk indicates a wildcard on any number of characters, and the question 
mark indicates a wildcard on a single character. 


DESCRIPTION 
The XListFonts function returns an array of available font names (as controlled by the font search path; 
see XSetFontPath ) that match the string you passed to the pattern argument. 


The XFreeFontNames function frees the array and strings returned by XListFonts. 


SEE ALSO 
XLoadFont(3X), XSetFontPath(3X) 
Xlib — C Language X Interface 
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NAME 
XLoadFont, XQueryFont, XListFontsWithInfo, XFreeFontInfo, XLoadQueryFont, XFreeFont, XGet- 


FontProperty, XUnloadFont, XGContextFromGC — manipulate fonts 


SYNTAX 
Font XLoadFont( display, name) 
Display *display; 
char *name; 


XFontStruct *XQueryFont (display, font_ID) 
Display *display; 
XID font_ID; 
char **XListFontsWithInfo( display, pattern, maxnames, count_return, info_return) 
Display *display; 
char *pattern; 
int maxnames ; 
int *count_return; 
XFontStruct **info_return; 


XFreeF ontInfo(names, free_info, actual_count) 
char **names; 
XFontStruct *free_info; 
int actual_count; 


XFontStruct *XLoadQueryFont (display, name) 
Display *display; 
char *name; 
XFreeFont (display, font_struct) 
Display *display; 
XFontStruct *font_struct; 
Bool XGetFontProperty (font_struct, atom, value_return) 
XFontStruct *font_struct; 
Atom atom; 
unsigned long *value_return; 


XUnloadFont (display, font) 


Display *display; 
Font font; 
GContext X GContextFromGC (gc) 
GC ge; 
OPTIONS 
actual_count Must be the actual number of matched font names returned by XList- 
FontsWithInfo. 
atom Specifies the atom associated with the string name you want returned. 
count_return Returns the actual number of matched font names. 
display Specifies the connection to the X server. 
font Specifies the font ID. 
font_ID Specifies the ID of the font or the graphics context. 
gc Specifies the graphics context that you want the resource for. 
font_struct Specifies the storage associated with the font. 
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info_return Returns a pointer to the font information. 

free_info Must be the pointer to font information returned by XListFontWithInfo. 
maxnames Specifies the maximum number of names that are to be in the returned list. 

name Specifies the name of the font. This name is a null terminated string. 

names Must be the list of font names returned by. XListFontsWithInfo. 

pattern Specifies the null-terminated string associated with the font names that you want 


retumed. You can specify any string, an asterisk ‘‘*’’, or a question mark ‘‘?’’, 
The asterisk indicates a wildcard on any number of characters, and the question 
mark indicates a wildcard on a single character. 


value_return Returns the value of the font property. 


DESCRIPTION 
The XLoadFont function loads the specified font and returns its associated font ID. XLoadFont can gen- 
erate BadAlloc and BadName errors. 


The XQueryFont function returns a pointer to the XFontStruct structure, which contains information 
associated with the font. XLoadQueryFont can generate a BadAlloc error. 


The XListFontsWithInfo function returns a list of names of fonts that match the specified pattern and their 
associated font information. 


The XFreeFontInfo function frees the the font information array. 


The XLoadQueryFont function provides the most common way for accessing a font. That is, XLoad- 
QueryFont both opens (loads) the specified font and returns a pointer to the appropriate XFontStruct 
structure. 


The XFreeFont function deletes the association between the font resource ID and the specified font. The 
font itself will be freed when no other resource references it. The data and the font should not be refer- 
enced again. XFreeF ont can generate a BadFont error. 


Given the atom for that property, the XGetFontProperty function returns the value of the specified font 
property. The function returns zero if the atom was not defined or one if it was defined. 


The XUnloadFont function deletes the association between the font resource ID and the specified font. 
XUnloadFont can generate a BadFont error. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadFont A value for a font or GContext argument does not name a defined font. 
BadName A font or color of the specified name does not exist. 

SEE ALSO 


XListFonts(3X), XSetFontPathGX) 
Xlib — C Language X Interface 
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NAME 
XLookupKeysym, XRefreshKeyboardMapping, XLookupString, XRebindKeySym — handle keyboard 
input events 
SYNTAX 


KeySym XLookupKeysym(event_key, index) 


XKeyEvent *event_key; 
int index; 


XRefreshKeyboardMapping(event_map) 


XMappingEvent *event_map; 


int XLookupString(event_struct, buffer_return, bytes_buffer, keysym_return, status_return) 


XKeyEvent *event_struct; 

char *buffer_return; 

int bytes_buffer; 

KeySym *keysym_return; 
XComposeStatus *status_return; 


XRebindKeysym( display, keysym, list, mod_count, string, bytes_string) 


OPTIONS 


buffer_return 


Display *display; 
KeySym keysym; 
KeySym *list; 

int mod_count; 
unsigned char *string; 
int bytes_string; 


Returns the translated characters. 


bytes_buffer 


bytes_string 
display 
event_key 


event_map 


event_struct 


index 

keysym 
keysym_return 
list 

mod_count 


status_return 


string 


DESCRIPTION 


Specifies the length of the buffer. No more than bytes_buffer of translation are 
retumed. 


Specifies the length of the string. 
Specifies the connection to the X server. 


Specifies the key event that is to be used. This event is either a KeyPress event or 
a KeyRelease event. 


Specifies the mapping event that is to be used. 


Specifies the key event structure to be used: XKeyPressedEvent or 
XKeyReleasedEvent. 


Specifies the index into the KeySyms table. 

Specifies the keysym to be rebound. 

Returns the keysym computed from the event if this argument is not NULL. 
Specifies a pointer to an array of keysyms that are being used as modifiers. 
Specifies the number of modifiers in the modifier list. 


Specifies either a pointer to the XCompose structure that is to contain compose 
key state information and that allows compose key processing to take place, or 
NULL. 


Specifies a pointer to the string that is to be returned by XLookupString. 


The XLookupKeysym function uses a given keyboard event and the index you specified to return the 
KeySym from the list that corresponds to the keycode member in the XKeyPressedEvent or 
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NAME 
XMap Window, XMapRaised, XMapSubwindows — map windows 
SYNTAX 
XMapWindow (display, w) 
Display *display; 
Window w; 
XMapRaised (display, w) 
Display *display; 
Window w; 
XMapSubwindows (display, w) 
Display *display; 
Window w; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
DESCRIPTION 


XMapWindow (3X) 


The function maps the window and all of its subwindows which have had map requests. XMapWindow 


can generate a Bad Window error. 


The XMapRaised function essentially is similar to XMap Window in that it maps the window and all of its 
subwindows which have had map requests. However, it also raises the specified window to the top of the 


stack. XMapRaised can generate a Bad Window error. 


The XMapSubwindows function maps all subwindows for a specified window in top-to-bottom stacking 
order. The X server to generate an Expose event on each newly displayed window. XMapSubwindows 


can generate a BadWindow error. 


DIAGNOSTICS 

BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 

XChange WindowA ttributes(3X), XConfigureWindow(3X), 


XDestroy Window(3X), XRaiseWindow(3X), XUnmapWindow(3X) 


Xlib — C Language X Interface 
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XCreateWindow(3X), 


XOpenDisplay (3X ) X Window System Reference Manual 
NAME 

XOpenDisplay, XCloseDisplay, XNoOp — connect or disconnect to X server 
SYNTAX 


Display *XOpenDisplay(display_name) 
char *display_name; 


XCloseDisplay (display) 


XOpenDisplay (3X ) 


Display *display; 
XNoOp (display) 
Display *display; 
OPTIONS 
display Specifies the connection to the X server. 
display_name Specifies the hardware display name, which determines the display and communi- 
cations domain to be used. On a UNIX-based system, if the display_name is 
NULL, it defaults to the value of the DISPLAY environment variable. 
DESCRIPTION 


The XOpenDisplay function returns a Display structure that serves as the connection to the X server and 
that contains all the information about that X server. XOpenDisplay connects the specified hardware 
display to the server through TCP, UNIX domain, or DECnet stream communications protocols. 


The XCloseDisplay function closes the connection to the X server for the display specified in the Display 


structure. 


The XNoOp function essentially sends a NoOperation request to the X server, thereby exercising the con- 


nection. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 

XParseGeometry, XGeometry, XParseColor — parse window geometry and color 
SYNTAX 


int XParseGeometry (parsestring , x_return, y_return, width_return, height_return) 
char *parsestring; 
int *x_return, *y_return; 
int *width_return, *height_return; 


int XGeometry (display, screen, position, default_position, bwidth, fwidth, fheight, xadder , 
yadder , x_return, y_return, width_return, height_return) 
Display *display; 
int screen; 
char *position, *default_position; 
unsigned int bwidth; 
unsigned int fwidth, fheight; 
int xadder , yadder; 
int *x_return, *y_return; 
int *width_return, *height_return; 


Status XParseColor (display, cmap, spec, exact_def_return) 


exact_def_return 
spec 


width_return 
height_return 


xadder 
yadder 


x_ return 
y_return 


DESCRIPTION 


Display *display; 

Colormap cmap; 

char *spec; 

XColor *exact_def return; 

OPTIONS 

bwidth Specifies the border width. 
cmap Specifies the colormap ID. 
display Specifies the connection to the X server. 
fheight 
fwidth Specifies the font height and width in pixels (increment size). 
parsestring Specifies the string you want to parse. 
position 
default_position Specifies the geometry specifications. 
screen Specifies the screen. 


Returns the exact colors for later use and sets the DoRed, DoGreen, and DoBlue 
flags. 


Specifies the color name string. Uppercase and lowercase characters are accept- 
able. 
Returns the width and height determined. 


Specifies additional interior padding needed in the window. 


Returns the xoffset and yoffset determined. 


The XParseGeometry function parses standard window geometry strings. 
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The XGeometry function parses window geometry given an argument and a default position. 
The XParseColor function parses color values. XParseColor can generate a BadColor error. 


DIAGNOSTICS 
BadColor A value for a colormap argument does not name a defined colormap. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XPolygonRegion, XClipBox — generate regions 


SYNTAX 
Region XPolygonRegion (points, n, fill_rule) 
XPoint points[]; 
int n; 
int fill_rule,; 
XClipBox(r, rect) 


Region 7; 
XRectangle *rect; 
OPTIONS 
fill_rule Specifies the fill rule you want to set for the specified graphics context. You can 
pass one of these constants: EvenOddRule or WindingRule. 
n Specifies the number of points in the polygon. 
points Specifies an array of points. 
r Specifies the region. 
rect Specifies the rectangle. 
DESCRIPTION 


The XPolygonRegion function returns a region defined by the points array. 


The XClipBox function generates the smallest enclosing rectangle in the specified rectangle that is located 
in the specified region. 


SEE ALSO 
Xlib —- C Language X Interface 
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NAME 
XPutBackEvent — put events back on the queue 
SYNTAX 
XPutBackEvent (display, event) 
Display *display; 
XEvent *event; 
OPTIONS 
display Specifies the connection to the X server. 
event Specifies a pointer to the XEvent structure. This structure is a union of the indivi- 
dual structures declared for each event type. 
DESCRIPTION 
The XPutBackEvent function pushes an event back onto the head of the display’s event queue. 
SEE ALSO 


XFlush(3X), XIfEvent(3X) 
Xlib — C Language X Interface 
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NAME 
XPutimage, XGetImage, XGetSubImage — transfer images 
SYNTAX 
XPutImage (display, d, gc, image, src_x, src_y, dst_x, dst_y, width, height) 
Display *display; 
Drawable d; 
GC gc; 


XImage *image; 

int src_xX, STC_y; 

int dst_x, dst_y; 

unsigned int width, height; 


XImage *XGetImage (display, d, x, y, width, height, plane_mask, format) 
Display *display; 
Drawable d; 
int x, y; 
unsigned int width, height; 
long plane_mask; 
int format; . 
XImage *X GetSubImage (display, d, x, y, width, height, plane_mask, format, dest_image , dest_x, 
dest_y) 
Display *display; 
Drawable d; 
int x, y; 
unsigned int width, height; 
unsigned long plane_mask; 
int format; 
XImage *dest_image; 
int dest_x, dest_y; 
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OPTIONS 

d Specifies the drawable. 

dest_x 

dest_y Specifies the x and y coordinates of the destination rectangle relative to its origin. 
These coordinates specify the upper-left corner of the destination rectangle. 
These coordinates determine where the subimage will be placed within the desti- 
nation image. 

display Specifies the connection to the X server. 

dst_x 

dst_y Specifies the x and y coordinates. These are the coordinates of the subimage and 
are relative to the origin of the drawable where the image will be drawn. 

format Specifies the format for the image. You can pass one of these constants: XYPix- 
map or ZPixmap. 

gc Specifies the graphics context. 

image Specifies the image you want combined with the rectangle. 

plane_mask Specifies the plane mask. 

src_x Specifies the offset in X from the left edge of the image defined by the XImage 
data structure. 

src_y Specifies the offset in from the top edge of the image defined by the XImage data 
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structure. 

width 

height Specifies the width and height of the subimage. These arguments define the 
dimensions of the rectangle. 

x 

y Specifies the x and y coordinates. These coordinates define the upper-left corner 
of the rectangle and are relative to the origin of the drawable. 

DESCRIPTION 


The XPutImage function combines an image in memory with a rectangle of the specified drawable. XPu- 
tImage can generate BadDrawable, BadGC, BadMatch, and BadValue errors. 


The XGetImage function returns the XImage structure. This structure provides you with the contents of 
the specified rectangle of the drawable in the format you specify. XGetImage can generate BadDraw- 
able, BadMatch, and BadValue errors. 


The XGetSubImage function copies the contents of a rectangle in the specified drawable on the display to 
the specified location within a pre-existing image structure. XGetSubImage can generate BadDrawable, 
BadGC, BadMatch, and BadValue errors. 


DIAGNOSTICS 

BadDrawable A value for a drawable argument does not name a defined window or pixmap. 

BadGC A value for a GContext argument does not name a defined GContext. 

BadMatch An InputOnly window is used as a drawable. 

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


Xlib — C Language X Interface 
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NAME 


X Window System Reference Manual XQueryBestSize (3X) 


XQueryBestSize, XQueryBestTile, XQueryBestStipple — determine efficient sizes 


SYNTAX 


Status XQueryBestSize (display, class, which_screen, width, height, width_return, height_return) 
Display *display; . 


int class; 


Drawable which_screen; 
unsigned int width, height; 
unsigned int *width_return, *height_return; 


Status XQueryBestTile (display, which_screen, width, height, width_return, height_return) 
Display *display; 
Drawable which_screen; 
unsigned int width, height; 
unsigned int *width_return, *height_return; 


Status XQueryBestStipple (display, which_screen, width, height, width_return, height_return) 


Display *display; 
Drawable which_screen; 
unsigned int width, height; 
unsigned int *width_return, *height_return; 
OPTIONS 
class Specifies the class that you are interested in. You can pass one of these constants: 
TileShape, CursorShape, or StippleShape. 
display Specifies the connection to the X server. 
width 
height Specifies the width and height. 


which_screen 


width_return 
height_return 


DESCRIPTION 


Specifies any drawable on a screen. 


Returns the width and height of the object best supported by the display hardware. 


The XQueryBestSize function returns the best or closest size to the specified size. XQueryBestSize can 
generate BadDrawable, BadMatch, and BadValue errors. 


The XQueryBestTile function returns the best or closest size, that is, the size that can be tiled fastest on 
the screen specified by which_screen. XQueryBestTile can generate BadDrawable and BadMatch 


errors. 


The XQueryBestStipple function returns the best or closest size, that is, the size that can be stippled fastest 
on the screen specified by which_screen. XQueryBestStipple can generate BadDrawable and BadMatch 


CIrors. 


DIAGNOSTICS 
BadMatch 


BadDraw 
BadMatch 
BadValue 
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An InputOnly window is used as a drawable. 
A value for a drawable argument does not name a defined window or pixmap. 
The values do not exist for an InputOnly window. 


Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate thiserror. _ 
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SEE ALSO 

XCreateGC(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), XSetFont(3X), 
XSetLineAttributes(3X), XSetState(3X), XSetTile(3X) 

Xlib — C Language X Interface 
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NAME 
XQueryColor, XQueryColors, XLookupColor — obtain color values 


SYNTAX 
XQueryColor (display, cmap, def_return) 
Display *display; 
Colormap cmap; 
XColor *def_return; 


XQueryColors (display, cmap, defs_return, ncolors) 
Display *display; 
Colormap cmap; 
XColor defs_return{]; 
int ncolors; 


XQueryColor (3X ) 


Status XLookupColor (display, cmap, color_name, visual_def_return, exact_def_return) 


Display *display; 

Colormap cmap; 

char *color_name; 

XColor *visual_def_return, *exact_def return; 


OPTIONS 
cmap Specifies the colormap ID. 
def_in_out Specifies or returns the RGB values for the pixel specified in the structure. 
defs_in_out Specifies or returns an array of color definition structures. 
display Specifies the connection to the X server. 
exact_def_return Returns the exact RGB values. 
ncolors Specifies the number of XColor structures in the color definition array. 
exact_def_return Returns the exact colors for later use and sets the DoRed, DoGreen, and DoBlue 
flags. 
DESCRIPTION 


The XQueryColor and XQueryColors functions returns the red, green, and blue color values stored in the 
specified colormap for the pixel value you pass in the pixel member of the XColor structure(s). The values 
returned for an unallocated entry are undefined. They also set the flags member in the XColor structure to 
all three colors. XQueryColor and XQueryColors can generate BadColor and BadValue errors. 


The XLookupColor function looks up the string name of a color with respect to the screen associated with 
the specified cmap and returns both the exact color values and the closest values provided by the screen 


with respect to the visual type of the specified cmap. 
DIAGNOSTICS 


BadColor A value for a colormap argument does not name a defined colormap. 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
XAllocColor(3X), XCreateColormap(3X), XStoreColors(3X) 
Xlib — C Language X Interface 
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NAME 
XQueryPointer — get pointer coordinates 


SYNTAX 
Bool XQueryPointer (display, w, root_return, child_return, root_x_return, root_y_return, 
win_x_return, win_y_return, mask_return) 
Display *display; 
Window w; 
Window *root_return, *child_return; 
int *root_x_return, *root_y_return; 
int *win_x_return, *win_y_return; 
unsigned int *mask_return; 


OPTIONS 
child_return Returns the child window ID that the pointer is located in, if any. 
display Specifies the connection to the X server. 
mask_return Returns the current state of the modifier keys and pointer buttons. 
root_return Returns the root window ID for the specified window. 
root_x_return 
root_y_return Returns the pointer coordinates relative to the root window’s origin. 
w Specifies the window ID. 
win_x_return 
win_y_return Returns the pointer coordinates relative to the specified window. 
DESCRIPTION 


The XQueryPointer function returns the root window the pointer is logically on and the pointer coordi- 
nates relative to the root window’s origin. XQueryPointer can generate a Bad Window error. 


DIAGNOSTICS 
BadWindow A value for a window argument does not name a defined window. 


SEE ALSO 
XGetWindowA ttributes(3X), XQueryTree(3X) 
Xlib — C Language X Interface 
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NAME 
XQueryTree — query window tree information 
SYNTAX 
Status XQueryTree (display, w, root_return, parent_return, children_return, nchildren_return) 
Display *display; 
Window w; 
Window *root_return; 
Window *parent_return; 
Window **children_return; 
unsigned int *nchildren_return; 
OPTIONS 
children_return Returns a pointer to the list of children for the specified window. 
display Specifies the connection to the X server. 
nchildren_return Returns the number of children for the specified window. 
parent_return Returns the parent window ID for the specified window. 
root_return Returns the root window ID for the specified window. 
w Specifies the window ID. 
DESCRIPTION 


The XQueryTree function returms the root ID, the parent window ID, a pointer to the list of children win- 
dows, and the number of children in the list for the specified window. XQueryTree can generate a 
BadWindow error. 


BUGS 
This really should return a screen *, not a root window ID. 


DIAGNOSTICS 
BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XGetWindowA ttributes(3X), XQueryPointer(3X) 
Xlib — C Language X Interface 
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NAME 


XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCirculateSubwindowsUp, XCircula- 
teSubwindowsDown, XRestack Windows — change window stacking order 


SYNTAX 
XRaiseWindow( display, w) 
Display *display; 
Window w; 
XLower Window (display, w) 
Display *display; 
Window w; 
XCirculateSubwindows (display, w, direction) 
Display *display; 
Window w; 
int direction; 
XCirculateSubwindowsUp (display, w) 
Display *display; 
Window w; 
XCirculateSubwindowsDown (display, w) 
Display *display; 
Window w; 
XRestack Windows (display, windows, nwindows); 
Display *display; 
Window windows (]; 
int nwindows; 
OPTIONS 
direction Specifies the direction (up or down) that you want to circulate the window. You 
can pass one of these constants: RaiseLowest or LowerHighest. 
display Specifies the connection to the X server. 
nwindows Specifies the number of windows to be restacked. 
Ww Specifies the window ID. 
windows . Specifies an array containing the windows to be restacked. All the windows must 
have the same parent. 
DESCRIPTION 


The XRaise Window function raises the specified window to the top of the stack so that no sibling window 
obscures it. XRaiseWindow can generate a BadWindow error. 


The XLowerWindow function lowers the specified window to the bottom of the stack so that it does not 
obscure any sibling windows. XLower Window can generate a BadWindow error. 

The XCirculateSubwindows function circulates the specified subwindow in the specified direction: 
RaiseLowest or LowerHighest. XCirculateSubwindows can generate BadValue and BadWindow 
errors. 

The XCirculateSubwindowsUp function raises the lowest mapped child of the specified window that is 
partially or completely occluded by another child. XCirculateSubwindowsUp can generate a BadWin- 
dow error. 

The XCirculateSubwindowsDown function lowers the highest mapped child of the specified window that 
partially or completely occludes another child. XCirculateSubwindowsDown can generate a BadWin- 
dow error. 
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The XRestack Windows function restacks the windows in the order specified, from top to bottom. The 
stacking order of the first window in the windows array will be unaffected, but the other windows in the 
array will be stacked underneath the first window in the order of the array. The stacking order of the other 
windows is not affected. XRestackWindows can generate Bad Window error. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XChangeWindowAttributes(3X), XConfigureWindow(3X), XCreateWindow(3X), 
XDestroyWindow(3X), XMapWindow(3X), XUnmapWindow(3X) 
Xlib — C Language X Interface 
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NAME 
XReadBitmapFile, XWriteBitmapFile, XCreatePixmapFromBitmapData, XCreateBitmapFromData — 
manipulate bitmaps 
SYNTAX 


int XReadBitmapFile( display, d, filename, width_return, height_return, bitmap_return, x_hot_return, 

y_hot_return) 

Display *display; 

Drawable d; 

char *filename ; 

unsigned int *width_return, *height_return; 

Pixmap *bitmap_return; 

int *x_hot_return, *y_hot_return; 


int XWriteBitmapFile( display, filename, bitmap, width, height, x_hot, y_hot) 
Display *display; 
char *filename ; 
Pixmap bitmap; 
unsigned int width, height; 
int x_hot, y_hot; 
Pixmap XCreatePixmapFromBitmapData( display, d, data, width, height, fg, bg, depth) 
Display *display; 
Drawable d; 
char *data; 
unsigned int width, height; 
unsigned long fg, bg; 
unsigned int depth; 


Pixmap XCreateBitmapFromData( display, d, data, width, height) 
Display *display; 
Drawable d; 
char *daia; 
unsigned int width, height; 


OPTIONS 
bitmap Specifies the bitmap to be written. 


bitmap_return 
d 

data 

data 

display 

depth 


fg 
bg 


filename 


width 
height 
width_return 
height_return 
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Returns the bitmap ID that is created. 
Specifies the drawable. 

Specifies the data in bitmap format. 
Specifies the location of the bitmap data. 
Specifies the connection to the X server. 
Specifies the depth of the pixmap. 


Specifies the foreground and background pixel values to use. 

Specifies the file name to use. The format of the file name is operating system 
specific. 

Specifies the width and height. 


Returns the width and height values of the read-in bitmap file. 
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x_ hot . 

y_hot Specifies where to place the hot spot coordinates (or -1,-1 if none are present) in 
the file. 

x_hot_return 

y_hot_return Returns the hot spot coordinates. 


DESCRIPTION : 
The XReadBitmapFile function reads in a file containing a bitmap. 


The XWriteBitmapFile function writes a bitmap out to a file. 


XCreatePixmapFromBitmapData creates a pixmap of the given depth and then does a bitmap-format 
XPutimage of the data into it. 


The XCreateBitmapFromData function allows you to include in your C program (using #include) a bit- 
map file that was written out by XWriteBitmapFile (X version 11 format only). 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XRecolorCursor, XFreeCursor, XQueryBestCursor — manipulate cursors 


SYNTAX 
XRecolorCursor (display, cursor, foreground_color, background_color) 
Display *display; 
Cursor cursor; 
XColor *foreground_color, *background_color; 


XFreeCursor (display, cursor) 


Display *display; 
Cursor cursor; 
Status XQueryBestCursor (display, d, width, height, width_return, height_return) 
Display *display; 
Drawable d; 
unsigned int width, height; 
unsigned int *width_return, *height_return; 
OPTIONS 
background_color Specifies the red, green, and blue (RGB) values for the background of the source. 
cursor Specifies the cursor. 
d Specifies the drawable. 
display Specifies the connection to the X server. 
foreground_color Specifies the red, green, and blue (RGB) values for the foreground of the source. 
width 
height Specifies the width and height of the cursor that you want the size information for. 
width_return . 
height_return Returns the best width and height (that is, closest to the specified width and 
height). 
DESCRIPTION 


The XRecolorCursor function changes the color of the specified cursor, and, if the cursor is being 
displayed on a screen, the change is visible immediately. XRecolorCursor can generate a BadCursor 
error. 


The XFreeCursor function deletes the association between the cursor resource ID and the specified cursor. 
XFreeCursor can generate a BadCursor error. 


The XQueryBestCursor function returns the closest shape actually supported by the display hardware. 
XQueryBestCursor can generate a BadDrawable error. 


DIAGNOSTICS 

BadCursor A value for a cursor argument does not name a defined cursor. 

BadDrawable A value for a drawable argument does not name a defined window or pixmap. 
SEE ALSO 


XCreateFontCursor(3X), XDefineC usor(3X) 
Xlib — C Language X Interface 
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NAME 
XReparentWindow — reparent windows 
SYNTAX 
XReparentWindow (display, w, parent, x, y) 
Display *display; 
Window w; 
Window parent; 
int x, y; 
OPTIONS 
display Specifies the connection to the X server. 
parent Specifies the parent window ID. 
Ww Specifies the window ID. 
x 
y Specifies the x and y coordinates of the position in the new parent window of the 
specified window. 
DESCRIPTION 


The XReparentWindow function reparents the specified window by inserting it as the child of the 
specified parent. XReparentWindow can generate BadMatch and Bad Window errors. 


DIAGNOSTICS 

BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 

XChangeSaveSet(3X) 


Xlib — C Language X Interface 
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NAME 
XSaveContext, XFindContext, XDeleteContext, XUniqueContext — manipulate the context manager 


SYNTAX 
int XSaveContext( display, w, context, data) 
Display *display; 
Window w; 
XContext context; 
caddr_t data; 


int XFindContext( display, w, context, data_return) 
Display *display; 
Window w; 
XContext context; 
caddr_t *data_return; 


int XDeleteContext( display, w, context) 


Display *display; 
Window w; 
XContext context; 
XContext XUniqueContext() 
OPTIONS 
context Specifies the context type to which the data belongs. 
data Specifies the data to be associated with the window and type. 
data_return Returns a pointer to the data. 
display Specifies the connection to the X server. 
w Specifies the window with which the data is associated. 
DESCRIPTION 


The XSaveContext function saves a data value that corresponds to a window and context type. 
The XFindContext function gets the data associated with a window and type. 
The XDeleteContext function deletes an entry for a given window and type. 


The XUniqueContext function creates a unique context type that may be used in subsequent calls to 
XSaveContext. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XSelectInput — select input events 
SYNTAX 
XSelectInput (display, w, event_mask) 
Display *display; 
Window w; 
unsigned long event_mask; 
OPTIONS 
display Specifies the connection to the X server. 
event_mask Specifies the event mask. This mask is the bitwise inclusive OR of one or more of 
the valid event mask bits. 
w Specifies the window ID. 
DESCRIPTION 


The XSelectInput function requests that the X server report the events associated with the event masks that 
you pass to the event_mask argument. XSelectInput can generate BadValue and BadWindow errors. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
Xlib — C Language X Interface 


INTEGRATED SOLUTIONS 1 


XSetArcMode (3X ) X Window System Reference Manual XSetArcMode (3X ) 


NAME 
XSetArcMode, XSetSubwindowMode, XSetGraphicsExposure — GC convenience routines 


SYNTAX 

XSetArcMode (display, gc, arc_mode) 
Display *display; 
GC gc; 
int arc_mode; 

XSetSubwindowMode (display, gc, subwindow_mode) 
Display *display; 
GC ge; 
int subwindow_mode ; 


XSetGraphicsExposures (display, gc, graphics_exposures) 


Display *display; 
GC ge; 
Boolean graphics_exposures; 
OPTIONS 
arc_mode Specifies the arc mode: ArcChord specifies that arcs will be chord filled, while 
ArcPieSlice specifies that arcs will be pie slice filled. 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 


graphics exposures Specifies whether you want GraphicsExpose events to be reported when calling 
XCopyArea and XCopyPlane with this graphics context. If True, GraphicsEx- 
pose events are reported. If False, GraphicsExpose events are not reported. 


subwindow_mode Specifies the subwindow mode: ClipByChildren clips source and destination by 
all viewable children, while IncludeInferiors draws through all subwindows, that 
is, does not clip by inferiors. 


DESCRIPTION 
The XSetArcMode function sets the arc mode in the specified graphics context. XSetArcMode can gen- 
erate BadGC and BadValue errors. 


The XSetSubwindowMode function sets the subwindow mode in the specified graphics context. XSet- 
SubwindowMode can generate BadGC and BadValue errors. 


The XSetGraphicsExposures function sets the graphics-exposures flag in the specified graphics context. 
XSetGraphicsExposures can generate BadGC and Bad Value errors. 


DIAGNOSTICS 

BadGC A value for a GContext argument does not name a defined GContext. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XCreateGC(3X), XQueryBestSize(3X), XSetClipOrigin(3X), XSetFillStyle(3X), XSetFont(3X), 
XSetLineAttributes(3X), XSetState(3X), XSetTile(3X) 
Xlib — C Language X Interface 
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NAME 
XSetClassHint, XGetClassHint — set or get class hint 
SYNTAX 
XSetClassHint (display, w, class_hints) 
Display *display; 
Window w; 


XClassHint *class_hints; 
Status XGetClassHint (display, w, class_hints_return) 


Display *display; 
Window w; 
XClassHint *class_hints_return; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
class_hints Specifies a pointer to a XClassHint structure that is to be used. 
class_hints_return Returns the XClassHints structure. 
DESCRIPTION 


The XSetClassHint functions sets the class hint for the specified window. XSetClassHint can generate 
BadAlloc and BadWindow errors. 


The XGetClassHint function obtains the class of the specified window. XGetClassHint can generate a 


BadWindow error. 
PROPERTY 
WM_CLASS 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), 
XSetSizeHints(3X), XSetStandardProperties(3X), XSetTransientForHint(3X), XSetWMuHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 


SYNTAX 
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XSetClipOrigin, XSetClipMask, XSetClipRectangles - GC convenience routines 


XSetClipOrigin (display, gc, clip_x_origin, clip_y_origin) 
Display *display; 


GC ge; 


int clip_x_origin, clip_y_origin; 


XSetClipMask (display, gc, pixmap) 
Display *display; 


GC gc; 


Pixmap pixmap; 
XSetClipRectangles (display, gc, clip_x_origin, clip_y_origin, rectangles, n, ordering) 
Display *display; 


GC ge; 


int clip_x_origin, clip_y_origin; 
XRectangle rectangles{(]; 


int n; 


int ordering; 


OPTIONS 
display 
clip_x_origin 
clip_y_origin 
gc 
n 


ordering 


pixmap 
rectangles 
DESCRIPTION 


Specifies the connection to the X server. 


Specifies the x and y coordinates of the clip origin. 
Specifies the graphics context. 
Specifies the number of rectangles. 


Specifies the ordering relations on the rectangles. Possible values are Unsorted, 
YSorted, YXSorted, or YXBanded. 


Specifies the pixmap. 
Specifies an array of rectangles. 


The XSetClipOrigin function sets the clip origin in the specified graphics context. XSetClipOrigin can 
generate a BadGC error. 


The XSetClipMask function sets the clip_mask in the specified graphics context to the specified pixmap. 
XSetClipMask can generate BadGC, BadMatch, and BadValue errors. 


The XSetClipRectangles function changes the clip_mask in the specified graphics context to the specified 
list of rectangles and sets the clip origin. XSetClipRectangles can generate BadAlloc, BadGC, Bad- 
Match, and Bad Value errors. 


DIAGNOSTICS 
BadAlloc 


BadGC | 
BadMatch 


BadValue 
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The server failed to allocate the requested resource or server memory. 
A value for a GContext argument does not name a defined GContext. 


Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 


Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


INTEGRATED SOLUTIONS 1 
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SEE ALSO 

XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetFillStyle(3X), XSetFont(3X), 
XSetLineAttributes(3X), XSetState(3X), XSetTile(3X) 

Xlib — C Language X Interface 
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NAME 
XSetCloseDownMode, XKillClient — control clients 


SYNTAX 
- XSetCloseDownMode (display, close_mode) 
Display *display; 
int close_mode; 


XKillClient( display, resource) 


Display *display; 
XID resource; 
OPTIONS . 
close_mode Specifies the client close down mode you want to change. You can pass one of 
these constants: DestroyAll, RetainPermanent, or RetainTemporary. 
display ~ Specifies the connection to the X server. 
resource Specifies any resource associated with the client you want to destroy. You can 
also pass AllTemporary. 
DESCRIPTION 


XSetCloseDownMode (3X ) 


The XSetCloseDownMode defines what will happen to the client’s resources at connection close. 


XSetCloseDownMode can generate a BadValue error. 


The XKillClient function forces a close-down of the client that created the resource if a valid resource is 


specified. XKillClient can generate a BadValue error. 
DIAGNOSTICS 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XSetCommand — set command atom 
SYNTAX 
XSetCommand (display, w, argv, argc) 
Display *display; 
Window w; 
char **argv; 
int argc; 
OPTIONS 
argc Specifies the number of arguments. 
argv Specifies a pointer to the command and arguments used to start the application. 
display Specifies the connection to the X server. 
Ww Specifies the window ID. 
DESCRIPTION 


The XSetCommand function records the command and arguments used to invoke the application. 
XSetCommand can generate BadAlloc and BadWindow errors. 


PROPERTY 
WM_COMMAND 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XSetClassHint(3X), XSetIconName(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), 
XSetSizeHints(3X), XSetStandardProperties(3X), XSetTransientForHint(3X), XSetWMHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XSetErrorHandler, XGetErrorText, XGetErrorDatabaseText, XDisplayName, XSetlOErrorHandler — 


default error handlers 


SYNTAX 
XSetErrorHandler (handler) 
int (* handler) (Display *, XErrorEvent *) 


XGetErrorText (display, code, buffer_return, length) 
Display *display; 
int code; 
char *buffer_return; 
int length; 


char *XDisplayName (string) 
char * string; 


XSetlOErrorHandler (handler) 
int (* handler) (Display *); 


XGetErrorDatabaseText (display, name, message, default_string, buffer_return, length) 
Display display; 
char *name, *message; 
char *default_string; 
char *buffer_return; 


int length; 
ARGUMENTS 
buffer Specifies the buffer that you want the error message stored in. 
code Specifies the error code for which you want to obtain a description. 
default_string Specifies the default error message. 
display Specifies the connection to the X server. 
handler Specifies the program’s supplied error handler. 
length Specifies the size of the buffer. 
message Specifies the type of the error message. 
name Specifies the name of the application. 
nbytes Specifies the number of bytes available in the buffer. 
string Specifies the character string. 
DESCRIPTION 


The XSetErrorHandler function handles error events. 


The XGetErrorText function copies a null-terminated string describing the specified error code into the 
specified buffer. 


The XDisplayName function returns the name of the display that you are currently using. 
The XSetIOErrorHandler sets the fatal IO error handler. 


The X GetError DatabaseText function returns a message (or the default message) from the error message 
database. 


SEE ALSO 
XSynchronize(3X) 
Xlib ~ C Language X Interface 
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NAME 
XSetFillStyle, XSetFillRule - GC convenience routines 
SYNTAX 
XSetFillStyle (display, gc, fill_style) 
Display *display; 
GC gc; 
int fill_style; 


XSetFillRule (display, gc, fill_rule) 


Display *display; 
GC gc; 
int fill_rule; 
OPTIONS . 
display Specifies the connection to the X server. 
fill_rule Specifies the fill rule you want to set for the specified graphics context. You can 
pass one of these constants: EvenOddRule or WindingRule. 
fill_style Specifies the fill style you want to set for the specified graphics context. Possible 
values are FillSolid, FillTiled, FillStippled, or FillOpaqueStippled. 
ge Specifies the graphics context. 
DESCRIPTION 
The XSetFillStyle function sets the fill style in the specified graphics context. XSetFillStyle can generate 
BadGC and BadValue errors. 
The XSetFillRule function sets the fill rule in the specified graphics context. XSetFillRule can generate 
BadGC and BadValue errors. 
DIAGNOSTICS 
BadGC A value for a GContext argument does not name a defined GContext. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


XSetFillStyle (3X) 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


SEE ALSO 


XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFont(3X), 


XSetLineAttributes(3X), XSetState(3X), XSetTile(3X) 
Xlib — C Language X Interface 
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NAME 
XSetFont — GC convenience routines 
SYNTAX 
XSetFont (display, gc, font) 
Display *display; 
GC gc; 
Font font; 
OPTIONS 
display Specifies the connection to the X server. 
font Specifies the font ID. 
ge Specifies the graphics context. 
DESCRIPTION 


The XSetFont function sets the current font in the specified graphics context. XSetFont can generate 
BadAlloc, BadFont, and BadGC errors. . 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadFont A value for a font or GContext argument does not name a defined font. 
BadGC A value for a GContext argument does not name a defined GContext. 
SEE ALSO 


XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), 
XSetLineAttributes(3X), XSetState(3X), XSetTile(3X) 
Xlib — C Language X Interface 
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NAME | 
XSetFontPath, XGetFontPath, XFreeFontPath — set, get, or free the font search path 
SYNTAX 
XSetFontPath (display, directories , ndirs) 
Display *display; 
char **directories; 
int ndirs; 
char **XGetFontPath (display, npaths_return) 
Display *display; 


int *npaths_return; 


XFreeFontPath (list) 
char **/ist; 
OPTIONS 
directories Specifies the directory path used to look for a font. Setting the path to the empty 
list restores the default path defined for the X server. 
display Specifies the connection to the X server. 
list Specifies the array of strings you want to free. 
ndirs Specifies the number of directories in the path. 
npaths_return Returns the number of strings in the font path array. 
DESCRIPTION 
The XSetFontPath function defines the directory search path for font lookup. XSetFontPath can generate 
a BadValue error. 


The XGetFontPath function allocates and returns an array of strings containing the search path. The data 
in the font path should be freed when no longer needed. 


The XFreeFontPath function, when presented the data from XGetFontPath, frees the data used by the 


array. 
DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 
SEE ALSO 


XListFont(3X), XLoadFonts(3X) 
Xlib — C Language X Interface 
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NAME 
XSetIconName, XGetIconName - set or get icon names 


SYNTAX 
XSetIconName (display, w, icon_name) 
Display *display; 
Window w; 
char *icon_name; 


int XGetIconName (display, w, icon_name_return) 


Display *display; 
Window w; 
char **icon_name_return; 
OPTIONS 
display Specifies the connection to the X server. 
icon_name Specifies the name to be displayed in the window’s icon. 


icon_name_return Returns a pointer to the name to be displayed in the window’s icon. The name will 
be a null-terminated string. 


Ww Specifies the window ID. 
DESCRIPTION 
The XSetIconName function sets the name to be displayed in a window’s icon. XSetIconName can gen- 
erate BadAlloc and Bad Window errors. 
The XGetIconName function obtains the window name to be displayed in its icon and either returns a 


nonzero if it succeeds or zero if it fails (for example, if no icon name has been set for the argument win- 
dow). XGetIconName can generate a Bad Window error. 


PROPERTY 
WM_ICON_NAME 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 


XSetClassHint(3X), XSetCommand(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), 
XSetSizeHints(3X), XSetStandardProperties(3X), XSetTransientForHint(3X), XSetWMHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 

Xlib — C Language X Interface 
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NAME 
XSetIconSizes, XGetIconSizes — set or get icon size hints 
SYNTAX 
XSetIconSizes (display, w, size_list, count) 
Display *display; 
Window w; 
XIconSize *size_list; 
int count; 
Status XGetIconSizes (display, w, size_list_return, count_return) 
Display *display; 
Window w; 
XIconSize **size_list_return; 
int *count_return; 
OPTIONS 
display Specifies the connection to the X server. 
count Specifies the number of items in the size list. 
count_return Returns the number of items in the size list. 
size_list Specifies a pointer to the size list. 
size_list_return Returns a pointer to the size list. 
w Specifies the window ID. 
DESCRIPTION 
The XSetIconSizes function sets the value of the icon size atom. XSetIconSizes can generate BadAlloc 
and Bad Window errors. 
The XGetIconSizes function returns the value of the icon sizes atom. XGetIconSizes can generate a 
BadWindow error. 
PROPERTY 
WM_ICON_SIZE 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO . 


XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetNormalHints(3X), 
XSetSizeHints(3X), XSetStandardProperties(3X), XSetTransientForHintGX), XSetWMHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 

Xlib ~ C Language X Interface 
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NAME 
XSetInputFocus, XGetInputFocus — control input focus 
SYNTAX 
XSetInputFocus (display, focus, revert_to, time) 
Display *display; 
Window focus; 
int revert_to; 
Time time; 


XGetInputFocus (display, focus_return, revert_to_return) 
Display *display; 
Window *focus_return; 
int *7evert_to_return; 


OPTIONS 
display Specifies the connection to the X server. 
focus Specifies the window ID. 
focus_return Returns the focus window ID, or either PointerRoot or None. 
revert_to Specifies which window the input focus reverts to if the window becomes not 
viewable. You can pass one of these constants: RevertToParent, RevertTo- 
PointerRoot, or RevertToNone. 
revert_to_return Returns the current focus state. The function can return one of these constants: 
RevertToParent, RevertToPointerRoot, or RevertToNone. 
time Specifies the time. You can pass either a timestamp, expressed in milliseconds, or 
CurrentTime. 
DESCRIPTION 


XSetInputFocus (3X ) 


The XSetInputFocus function changes the input focus and the last-focus-change time. XSetInputFocus 


can generate BadMatch, Bad Value, and Bad Window errors. 


The XGetInputFocus function returns the focus window ID and the current focus state. 


DIAGNOSTICS 


BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow A value for a window argument does not name a defined window. 


SEE ALSO 
XWarpPointer(3X) 
Xlib — C Language X Interface 
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NAME 
XSetLineAttribute, XSetDashes — GC convenience routines 


SYNTAX 
XSetLineAttributes (display, gc, line_width, line_style, cap_style, join_style) 
Display *display; 
GC ge; 
unsigned int line_width; 
int line_style; 
int cap_style; 
int join_style; 
XSetDashes (display, gc, dash_offset, dash_list, n) 
Display *display; 
GC gc; 
int dash_offset; 
char dash_list(}; 


int n; 
OPTIONS 
cap_style Specifies the line and cap style you want to set for the specified graphics context. 
Possible values are CapNotLast, CapButt, CapRound, or CapProjecting. 
dash _list Specifies the dash list for the dashed line style you want to set for the specified 
graphics context. 
dash_offset Specifies the phase of the pattern for the dashed line style you want to set for the 
specified graphics context. 
display Specifies the connection to the X server. 
ge Specifies the graphics context. 
join_style Specifies the line-join style you want to set for the specified graphics context. 
Possible values are JoinMiter, JoinRound, or JoinBevel. 
line_style Specifies the line style you want to set for the specified graphics context. Possible 
values are LineSolid (solid), LineOnOffDash (on-off dash), or LineDoubleDash 
(double dash). 
line_width Specifies the line width you want to set for the specified graphics context. 
n Specifies the number of elements in the dash list argument. 
DESCRIPTION 


The XSetLineAttributes function sets the line drawing components in the specified graphics context. 
XSetLineAttributes can generate BadGC and BadValue errors. 


The XSetDashes function sets the dash_offset and dash_list for dashed line styles in the specified graphics 
context. XSetDashes can generate BadAlloc, BadGC, and BadValue errors. 


DIAGNOSTICS 

BadAlloc The server failed to allocate the requested resource or server memory. 

BadGC A value for a GContext argument does not name a defined GContext. 

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 


XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), 
XSetFont(3X), XSetState(3X), XSetTile(3X) 
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NAME 
XSetNormalHints, XGetNormalHints — set or get normal state hints 
SYNTAX 
void XSetNormalHints (display, w, hints) 
Display *display; 
Window w; 
XSizeHints *hints; 
Status XGetNormalHints (display, w, hints_return) 
Display *display; 
Window w; 
XSizeHints *hints_return; 
OPTIONS 
display Specifies the connection to the X server. 
hints Specifies a pointer to the sizing hints for the window in its normal state. 
hints_return Returns the sizing hints for the window in its normal state. 
Ww Specifies the window ID. 
DESCRIPTION 


The XSetNormalHints function sets the size hints for a window in its normal state. XSetNormalHints 
can generate BadAlloc and Bad Window errors. 


The XGetNormalHints function returns the size hints for a window in its normal state. XGetNor- 
malHints can generate a BadWindow error. 


PROPERTY 
WM_NORMAL_HINTS 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadWindow A value for a window argument does not name a defined window. 
SEE ALSO 


XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), XSetSizeHints(3X), 
XSetStandardProperties(3X), XSetWMHints(3X), XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XSetPointerMapping, XGetPointerMapping — manipulate pointer settings 
SYNTAX 
int XSetPointerMapping (display, map, nmap) 
Display *display; 
unsigned char map[]; 
int nmap; 
int XGetPointerMapping (display, map, nmap) 
Display *display; 
unsigned char map []; 
int nmap; 
OPTIONS 
display Specifies the connection to the X server. 
map Specifies the mapping list. 
nmap Specifies the number of items in mapping list. 
DESCRIPTION | 


The XSetPointerMapping function sets the mapping of the pointer and causes the X server to generate a 
MappingNotify event on a status of MappingSuccess. XSetPointerMapping can generate a BadValue 


error. 
The XGetPointerMapping function returns the current mapping of the pointer. 
DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. 
Unless a specific range is specified for an argument, the full range defined by the 
arguments type is accepted. Any argument defined as a set of alternatives can 
generate this error. 
SEE ALSO 


XChangeKeyboardControl(3X), XChangeKeyboardMapping(3X) 
Xlib — C Language X Interface 
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NAME 
XSetScreenSaver, XForceScreenSaver, XActivateScreenSaver, XResetScreenSaver, XGetScreenSaver — 


manipulate the screen saver 


SYNTAX 
XSetScreenSaver (display, timeout, interval, prefer_blanking, allow_exposures) 
Display *display; 
int timeout, interval; 
int prefer_blanking; 
int allow_exposures; 


XForceScreenSaver (display, mode) 
Display *display; 
int mode; 

XActivateScreenSaver (display) 
Display *display; 


XResetScreenSaver (display) 
Display *display; 


XGetScreenSaver (display, timeout_return, interval_return, prefer_blanking_return, 
allow_exposures_return) 
Display *display; 
int *timeout_return, *interval_return; 
int *prefer_blanking_return; 
int *allow_exposures_return; 


OPTIONS ; 
allow_exposures Specifies the current screen save control values. Possible values are Don- 
tAllowExposures, AllowExposures, or DefaultExposures. 
allow_exposures_return Returns the current screen save control value: DontAllowExposures, 
AllowExposures, or DefaultExposures. 
display Specifies the connection to the X server. 
interval Specifies the interval between screen saver invocations. 
interval_return Retums the interval between screen saver invocations. 
mode Specifies the mode that is to be applied. 
prefer_blanking Specifies whether to enable screen blanking. Possible values are DontPre- 
ferBlanking, PreferBlanking, or DefaultBlanking. 
prefer_blanking return Returns the current screen blanking preference: DontPreferBlanking, Pre- 
ferBlanking, or DefaultBlanking. 
timeout Specifies the timeout, in seconds, until the screen saver turns on. 
timeout_return Returns the timeout, in minutes, until the screen saver turns on. 
DESCRIPTION 


The XSetScreenSaver function sets the screen saver. XSetScreenSaver can generate a BadValue error. 


The XForceScreenSaver function forces the screen saver. XForceScreenSaver can generate a BadValue 
error. 


The XActivateScreenSaver function activates the screen saver. 


The XResetScreenSaver function resets the screen saver. 
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The XGetScreenSaver function gets the current screen saver values. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 
SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XSetSelectionOwner, XGetSelectionOwner, XConvertSelection — manipulate window selection 
SYNTAX 
XSetSelectionOwner (display, selection, owner , time) 
Display *display; 
Atom selection; 
Window owner; 
Time time; 


Window XGetSelectionOwner (display, selection) 
Display *display; 
Atom selection; 


XConvertSelection (display, selection, target, property, requestor, time) 


Display *display; 
Atom selection, target; 
Atom property; 
Window requestor; 
Time time; 
OPTIONS 
display Specifies the connection to the X server. 
owner Specifies the owner of the specified selection atom. You can pass a window ID or 
None. 
property Specifies the property atom. 
requestor Specifies the requestor. 
selection Specifies the selection atom. 
target Specifies the target atom. 
time Specifies the time. You can pass either a timestamp, expressed in milliseconds, or 
CurrentTime. 
DESCRIPTION 


The XSetSelectionOwner function changes the owner and last change time for the specified selection. 
XSetSelectionOwner can generate BadAtom and Bad Window errors. 


The XGetSelectionOwner function returns the window ID associated with the window that currently owns 
the specified selection. If no selection was specified, the function returns the constant None. XGetSelec- 
tionOwner can generate a BadAtom error. 


XConvertSelection requests that the specified selection be converted to the specified target type: 
e If the specified selection has an owner, the X server sends a SelectionRequest event to that owner. 


° If no owner for the specified selection exists, the X server generates a SelectionNotify event to the 
requestor with property None. The arguments are passed on unchanged in either event. XConvert- 
Selection can generate BadAtom and BadWindow errors. 


DIAGNOSTICS 
BadAtom A value for an atom argument does not name a defined atom. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XSetSizeHints, XGetSizeHints — set or get window size hints 
SYNTAX 
XSetSizeHints (display, w, hints, property) 
Display *display; 
Window w; 
XSizeHints *hints; 
Atom property; 
Status XGetSizeHints (display, w, hints_return, property) 
Display *display; 
Window w; 
XSizeHints *hints_return; 
Atom property; 
OPTIONS 
display Specifies the connection to the X server. 
hints Specifies a pointer to the size hints. 
hints_return Returns the size hints. 
property Specifies the property atom. 
w Specifies the window ID. 
DESCRIPTION 


The XSetSizeHints function sets the value of any property of type WM_SIZE_HINTS. XSetSizeHints 
can generate BadAlloc, BadAtom, and Bad Window errors. 


The XGetSizeHints function reads the value of any property of type WM_SIZE_HINTS. XGetSizeHints 
can generate BadAtom and Bad Window errors. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadAtom A value for an atom argument does not name a defined atom. 
BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 
XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), 
XSetNormalHints(3X), XSetStandardProperties(3X), XSetTransientForHint(3X), 


XSetWMHints(3X), XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XSetS tandardColormap, XGetStandardColormap — set or get standard colormaps 
SYNTAX 
void XSetStandardColormap( display, w, cmap, property) 
Display *display; 
Window w; 
XStandardColormap *cmap; 
Atom property; /* RGB_BEST_MAP, etc. */ 
Status XGetStandardColormap( display, w, cmap_return, property) 
Display *display; 
Window w; 
XStandardColormap *cmap_return; 
Atom property; /* RGB_BEST_MAP, etc. */ 
OPTIONS 
cmap Specifies the colormap ID. 
cmap_return Returns the colormap associated with the specified atom. 
display Specifies the connection to the X server. 
property Specifies the property atom. 
Ww Specifies the window ID. 
DESCRIPTION 


The XSetStandardColormap function creates or changes a standard colormap. XSetStandardColormap 
can generate BadAlloc, BadAtom, and BadWindow errors. 


The XGetStandardColormap function gets the XStandardColormap structure associated with one of the 
described atoms. XGetStandardColormap can generate BadAtom and Bad Window errors. 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadAtom A value for an atom argument does not name a defined atom. 
BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XSetStandardProperties — set standard window manager properties 
SYNTAX 
XSetStandardProperties (display, w, window_name, icon_name, icon_pixmap, argv, argc, hints) 
Display *display; 
Window w; 
char *window_name; 
char *icon_name; 
Pixmap icon_pixmap ; 
char **argv; 
int argc; 
XSizeHints *hints; 
OPTIONS 
argc Specifies the number of arguments. 
argv Specifies a pointer to the command and arguments used to start the application. 
display Specifies the connection to the X server. 
hints Specifies a pointer to the sizing hints for the window in its normal state. 
icon_name Specifies the name to be displayed in the window’s icon. 
icon_pixmap Specifies the single plane pixmap that is to be used for the icon or None. 
w Specifies the window ID. 
window_name Specifies the name of the window. 
DESCRIPTION 


The XSetStandardProperties function provides a means by which, with a single call, simple applications 
set the most essential properties. XSetStandardProperties can generate BadAlloc and BadWindow 
errors. 


PROPERTIES 
~ WM_NAME, WM_ICON_NAME, WM_HINTS, WM_COMMAND, and WM_NORMALHINTS 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadWindow A value for a window argument does not name a defined window. 


SEE ALSO 
XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), 
XSetNormalHints(3X), XSetSizeHints(3X), XSetTransientForHint(3X), © XSetWMHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XSetState, XSetFunction, XSetPlanemask, XSetForeground, XSetBackground — GC convenience routines 
SYNTAX 
XSetState (display, gc, foreground, background, function, plane_mask) 
Display *display; 
GC ge; 
unsigned long foreground, background; 
int function; 


unsigned long plane_mask; 


XSetFunction (display, gc, function) 
Display *display; 
GC gc; 
int function; 

XSetPlaneMask (display, gc, plane_mask) 
Display *display; 
GC gc; 
unsigned long plane_mask; 


XSetForeground (display, gc, foreground) 


Display *display; 
GC ge; 
unsigned long foreground; 
XSetBackground (display, gc, background) 
Display *display; 
GC gc; 
unsigned long background; 
OPTIONS 
background Specifies the background you want to set for the specified graphics context. 
display Specifies the connection to the X server. 
foreground Specifies the foreground you want to set for the specified graphics context. 
function Specifies the function you want to set for the specified graphics context. 
ge Specifies the graphics context. 
plane_mask Specifies the plane mask. 
DESCRIPTION 


The XSetState function sets the foreground, background, plane mask, and function components for the 
specified graphics context. XSetState can generate BadGC and BadValue errors. 


XSetFunction sets a specified value in the specified graphics context. XSetFunction can generate BadGC 
and BadValue errors. 


The XSetPlaneMask function sets the plane mask in the specified graphics context. XSetPlaneMask can 
generate a BadGC error. 


The XSetForeground function sets the foreground in the specified graphics context. XSetForeground 
can generate a BadGC error. 


The XSetBackground function sets the background in the specified graphics context. XSetBackground 
can generate a BadGC error. 


DIAGNOSTICS 
BadGC A value for a GContext argument does not name a defined GContext. 
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BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 

SEE ALSO 
XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), 


XSetFont(3X), XSetLineAttributes(3X), XSetTile(3X) 
Xlib — C Language X Interface 
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NAME 
XSetTile, XSetStipple, XSetTSOrigin — GC convenience routines 
SYNTAX 
XSetTile (display, gc, tile) 
Display *display; 
GC gc; 
Pixmap tile; 
XSetStipple (display, gc, stipple) 
Display *display; 
GC gc; 
Pixmap stipple; 
XSetTS Origin (display, gc, ts_x_origin, ts_y_origin) 
Display *display; 
GC gc; 
int ts_x_origin, ts_y_origin; 
OPTIONS 
display Specifies the connection to the X server. 
gc Specifies the graphics context. 
stipple Specifies the stipple you want to set for the specified graphics context. 
tile Specifies the fill tile you want to set for the specified graphics context. 
ts_x_ origin 
ts_y_origin Specifies the x and y coordinates of the tile or stipple origin. 
DESCRIPTION 


The XSetTile function sets the fill tile in the specified graphics context. XSetTile can generate BadAlloc, 
BadGC, BadMatch, and BadPixmap errors. 


The XSetStipple function sets the stipple in the specified graphics context. XSetStipple can generate 
BadAlloc, BadGC, BadMatch, and BadPixmap errors. 


The XSetTSOrigin function sets the tile/stipple origin in the specified graphics context. XSetTSOrigin 


can generate a BadGC error. 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadGC — A value for a GContext argument does not name a defined GContext. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 
BadPixmap A value for a pixmap argument does not name a defined pixmap. 
SEE ALSO 


XCreateGC(3X), XQueryBestSize(3X), XSetArcMode(3X), XSetClipOrigin(3X), XSetFillStyle(3X), 
XSetFont(3X), XSetLineAttributes(3X), XSetState(3X) 
Xlib — C Language X Interface 
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NAME 
XSetTransientForHint, XGetTransientForHint — set or get transient for hint 


SYNTAX 
XSetTransientForHint (display, w, prop_window) 
Display *display; 
Window w; 
Window prop_window; 


Status XGetTransientForHint (display, w, prop_window_return) 


Display *display; 
Window w; 
Window *prop_window_return; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
prop_window Specifies the window ID that the WM_TRANSIENT_FOR property is to be set to. 
prop_window_ return Returns the WM_TRANSIENT_FOR property of the specified window. 
DESCRIPTION 


The XSetTransientForHint set the WM_TRANSIENT_FOR atom of the specified window to: the 
specified prop_window. XSetTransientForHint can generate BadAlloc and Bad Window errors. 


The XGetTransientF orHint function obtains the WM_TRANSIENT_FOR property for the specified win- 
dow. XGetTransientForHint can generate a BadWindow error. 


PROPERTY 
WM_TRANSIENT_FOR 
DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 


XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), 
XSetNormalHints(3X), XSetSizeHints(3X), XSetStandardProperties(3X), XSetWMHints(3X), 
XSetZoomHints(3X), XStoreName(3X) 

Xlib — C Language X Interface 
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NAME 
XSetWMHints, XGetWMHints — set or get window manager hints 


SYNTAX 
XSetWMHints (display, w, wmhints) 
Display *display; 
Window w; 
XWMuHints *wmhints; 


XWMHints *XGetWMHints (display, w) 


Display *display; 
Window w; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
winhints Specifies a pointer to the window manager hints. 
DESCRIPTION | 


The XSetWMHints function sets the window manager hints that include icon information and location, the 
initial state of the window, and whether the application relies on the window manager to get keyboard 
input. XSetWMHints can generate BadAlloc and Bad Window errors. 


The XGetWMHints function reads the value of the window manager hints atom and returns either NULL 
if it fails (for example, if no WM_HINTS property was set on window w) or a pointer to a XWMHints 
structure if it succeeds. XGetWMHints can generate a BadWindow error. 


PROPERTY 
WML_HINTS 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), 
XSetNormalHints(3X), XSetSizeHints(3X), XSetStandardProperties(3X), 


XSetTransientForHint(3X), XSetZoomHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XSetZoomHints, XGetZoomHints — set or get zoom state hints 
SYNTAX 
XSetZoomHints (display, w, zhints) 
Display *display; 
Window w; 
XSizeHints *zhints; 
Status XGetZoomHints (display, w, zhints_return) 
Display *display; 
Window w; 
XSizeHints *zhints_return; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
zhints Specifies a pointer to the zoom hints. 
zhints_return Returns the zoom hints. 
DESCRIPTION 


The XSetZoomHints function sets the value of the zoom hints atom. XSetZoomHints can generate 
BadAlloc and BadWindow errors. 


The XGetZoomHints function returns the value of the zoom hints atom. XGetZoomHints can generate a 
BadWindow error. 


PROPERTY 
WM_ZOOM_HINTS 


DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 


BadWindow A value for a window argument does not name a defined window. 


SEE ALSO 
XSetClassHint(3X), XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), 
XSetNormalHints(3X), XSetSizeHints(3X), XSetStandardProperties(3X), 


XSetTransientForHint(3X), XSetWMHints(3X), XStoreName(3X) 
Xlib — C Language X Interface 
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NAME 
XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer, XRotateBuffers — manipulate cut and paste 


buffers 


SYNTAX 
XStoreBytes (display, bytes, nbytes) 
Display *display; 
char bytes[]; 
int nbytes; 


XStoreBuffer (display, bytes, nbytes , buffer) 
Display *display; 
char bytes[]; 
int nbytes; 
int buffer; 

char *XFetchBytes (display, nbytes_return) 
Display *display; 
int *nbytes_return; 

char *XFetchBuffer (display, nbytes_return, return_buffer) 
Display *display; 
int *nbytes_return; 
int return_buffer; 


XRotateBuffers (display, rotate) 


Display *display; 
int rotate; 
OPTIONS 
buffer Specifies the buffer in which you want to store the byte string. 
bytes Specifies the string of bytes you want stored. The byte string is not necessarily 
ASCII or null-terminated. 
display Specifies the connection to the X server. 
nbytes Specifies the number of bytes of the bytes argument that you want stored. 
nbytes_return Returns the number of bytes in the string to the buffer. 
return_buffer Specifies which buffer you want the stored data to be returned from. 
rotate Specifies how much to rotate the cut buffer. 
DESCRIPTION 


The XStoreBytes function returns the number of bytes to be stored to the si ae argument. XStoreBytes 
can generate BadAlloc and Bad Window errors. 


The XStoreBuffer function stores data in a specified cut buffer. XStoreBuffer can generate BadAlloc, 
BadAtom, and BadWindow errors. 


The XFetchBytes function retums the number of bytes in the nbytes argument, if the buffer contains data. 
Otherwise, the function returns NULL and sets nbytes to 0. XFetchBytes can generate a BadWindow 
error. 


The XFetchBuffer function returns the value zero to the nbytes argument if there is no data in the buffer. 
X¥FetchBuffer can generate a BadValue error. 


The XRotateBuffers function rotates the cut buffers, such that buffer 0 becomes buffer n, buffer 1 
becomes n+1 mod 8, and so on. This cut buffer numbering is global to the display. XRotateBuffers can 
generate BadAtom, BadMatch, and BadWindow errors. 
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DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadAtom A value for an atom argument does not name a defined atom. 
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in 
some other way required by the request. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 
XStoreColors, XStoreColor, XStoreNamedColor — set colors 
SYNTAX 
XStoreColors (display, cmap, color, ncolors) 
Display *display; 
Colormap cmap; 
XColor color{]; 
int ncolors; 
XStoreColor (display, cmap, color) 
Display *display; 
Colormap cmap; 
XColor *color; 
XStoreNamedColor (display, cmap, color, pixel, flags) 
Display *display; 
Colormap cmap; 
char * color; 
unsigned long pixel; 
int flags; 
OPTIONS 
cmap Specifies the colormap ID. 
color Specifies the pixel and RGB values. 
color Specifies an array of color definition structures to be stored. 
display Specifies the connection to the X server. 
flags Specifies which red, green, and blue indexes are set. 
ncolors Specifies the number of XColor structures in the color definition array. 
pixel Specifies the entry in the colormap. 
exact_def_return Returns the exact colors for later use and sets the DoRed, DoGreen, and DoBlue 
flags. 
DESCRIPTION 


The XStoreColors function changes the colormap entries of the pixel values specified in the pixel 
members of the XColor structures. XStoreColors can generate BadAccess, BadColor, and BadValue 
errors. 

The XStoreColor function changes the colormap entry of the pixel value specified in the pixel member of 
the XColor structure. XStoreColor can generate BadColor and BadValue errors. 


The XStoreNamedColor function looks up the named color with respect to the screen associated with 
cmap and stores the result in cmap. XStoreNamedColor can generate BadAccess, BadColor, BadName, 


and BadValue errors. 
DIAGNOSTICS 
BadAccess A client attempted to free a colormap entry that it did not already allocate. 
BadAccess A client attempted to store into a read-only colormap entry. 
BadColor A value for a colormap argument does not name a defined colormap. 
BadName A font or color of the specified name does not exist. 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 


specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 
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SEE ALSO 
XAllocColor(3X), XCreateColormap(3X), XQueryColor(3X) 
Xlib — C Language X Interface 
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NAME 
XStoreName, XFetchName — set or get window names 


SYNTAX 
XStoreName (display, w, window_name) 
Display *display; 
Window w; 
char *window_name; 


int XFetchName (display, w, window_name_return) 


Display *display; 
Window w; 
char **window_name_return; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
window_name Specifies the name of the window. 


window_name_return Returns a pointer to the window name, which will be a null-terminated string. 


DESCRIPTION 
The XStoreName function assigns the name passed to window_name to the specified window. 
XStoreName can generate BadAlloc and BadWindow errors. 


The XFetchName function obtains a window name and returns either a nonzero if it succeeds or zero if it 
fails (for example, if no name has been set for the argument window). XFetchName can generate a 
BadWindow error. 

PROPERTY 
WM_NAME 

DIAGNOSTICS 
BadAlloc The server failed to allocate the requested resource or server memory. 
BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), 
XSetSizeHints(3X), XSetStandardProperties(3X), XSetWMHints(3X), XSetZoomHints(3X) 
Xlib — C Language X Interface 
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NAME 
XStringToKeysym, XKeysymToString, XKeycodeToKeysym, XKeysymToKeycode — convert keysyms 


SYNTAX 

KeySym XStringToKeysym (string) 
char *string; 

char *XKeysymToString (keysym_str) 
KeySym keysym_str; 

KeySym XKeycodeToKeysym (display, keycode, index_return) 
Display *display; 
KeyCode keycode ; 
int index_return; 

KeyCode XKeysymToKeycode (display, keysym_kcode) 
Display *display; 
Keysym keysym_kcode; 


OPTIONS 

display Specifies the connection to the X server. 

index_return Returns the element of keycode vector. 

keycode Specifies the keycode. 

keysym_kcode Specifies the keysym that is to be searched for. 

keysym_str Specifies the keysym that is to be converted. 

string Specifies the name of the keysym that is to be converted. 
DESCRIPTION 


The XStringToKeysym function converts the name of the keysym to the keysym code. 
The XKeysymToString function converts a keysym code to the name of the keysym. 
The XKeycodeToKeysym function converts a keycode to a defined keysym. 

The XKeysymToKeycode function converts a keysym to the appropriate keycode. 


SEE ALSO 
XLookupKeysym(3X) 
Xlib — C Language X Interface 
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NAME 
. XSynchronize, XSetAfterFunction — enable or disable synchronization 
SYNTAX 
int («XSynchronize (display, onoff))0O 
Display *display; 
int onoff; 
int (*XSetAfterFunction (display, proc))0 
Display *display; 
int (* proc) (0; 
OPTIONS 
display Specifies the connection to the X server. 
proc Specifies the function to be called after an Xlib function that generates a protocol 
request completes its work. 
onoff Specifies whether to enable or disable synchronization. Possible values you. can 
pass are 0 (disable synchronization) or nonzero (enable synchronization). 
DESCRIPTION 
The XSynchronize function enables or disables synchronization. 
After completing their work, all Xlib functions that generate protocol requests call what is known as a pre- 
vious after function. XSetAfterFunction sets which function is to be called. 
SEE ALSO 


XSetErrorHandler(3X) 
Xlib — C Language X Interface 
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NAME 
XTextExtents, XTextExtents16, XQueryTextExtents, XQueryTextExtents16 — compute or query text 
extents 


SYNTAX 
XTextExtents (font_struct, string, nchars, direction_return, font_ascent_return, 
font_descent_return, overall_return) 
XFontStruct *font_struct; 
char *string; 
int nchars; 
int *direction_return; 
int *font_ascent_return, *font_descent_return; 
XCharStruct *overall_return; 


XTextExtents16 (font_struct, string, nchars, direction_return, font_ascent_return, 
font_descent_return, overall_return) 
XFontStruct *font_struct; 
XChar2b *string; 
int nchars; 
int *direction_return; 
int *font_ascent_return, *font_descent_return; 
XCharStruct *overall_return; 


XQueryTextExtents (display, font_ID, string, nchars, direction_return, font_ascent_return, 
font_descent_return, overall_return) 
Display *display; 
XID font_ID; 
Char *string; 
int nchars; 
int *direction_return; 
int *font_ascent_return, *font_descent_return; 
XCharStruct *overall_return; 


XQueryTextExtents16 (display, font_ID, string, nchars, direction_return, font_ascent_return, 
font_descent_return, overall_return) 
Display *display; 
XID font_ID; 
XChar2b *string; 
int nchars; 
int *direction_return; 
int *font_ascent_return, *font_descent_return; 
XCharStruct *overall_return; 


OPTIONS 
font_ascent_return Returns the font ascent member. 


font_descent_return Returns the font descent member. 


direction_return Returns the value of the direction hint member: FontLeftToRight or FontRight- 
ToLeft. 

display Specifies the connection to the X server. 

font_ID Specifies either the font ID or the graphics context that contains the font. 

font_struct ‘Specifies a pointer to the XFontStruct structure. 
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nchars_ .- Specifies the number of characters in the character string. 
string Specifies the character string. 
overall_return Returns the overall size in the specified XCharStruct structure. 
DESCRIPTION 
The XTextExtents and XTextExtents16 functions return the logical extents of the specified 1-byte and 2- 
byte character string. 


The XQueryTextExtents and XQueryTextExtents16 functions return the bounding box of the specified 
8-bit and 16-bit character string in the specified font or the font contained in the specified GC. 
XQueryTextExtents and XQueryTextExtents16 can generate BadFont and BadGC errors. 


DIAGNOSTICS 
BadFont A value for a font or GContext argument does not name a defined font. 
BadGC A value for a GContext argument does not name a defined GContext. 
SEE ALSO 
XTextWidth(3X) 


Xlib — C Language X Interface 
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NAME 
XTextWidth, XTextWidth16 ~ compute text width 


SYNTAX 

int XTextWidth (font_struct, string, count) 
XFontStruct *font_struct; 
char *string; 
int count; 

int XTextWidth16 (font_struct, string, count) 
XFontStruct *font_struct; 
XChar2b *string; 
int count; 


OPTIONS 


count Specifies the character count in the specified string. 
font_struct Specifies the font used for the width computation. 


string Specifies the character string. 
DESCRIPTION 


XTextWidth (3X) 


The XTextWidth and XTextWidth16 functions return the width of the specified strings, ignoring size 


bearings. 
SEE ALSO 


XTextExtents(3X) 
Xlib - C Language X Interface 
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NAME 
XTranslateCoordinates — translate window coordinates 


SYNTAX 
int XTranslateCoordinates (display, src_w, dest_w, src_x, src_y, dest_x_return, 
dest_y_return, child_return) 
Display *display; 
Window src_w, dest_w; 
int src_X, STC_Y; 
int *dest_x_return, *dest_y_return; 
Window *child_return; 


OPTIONS 
child_return Returns the child if the coordinates are contained in a mapped child of the destina- 
tion window. 
dest_w Specifies the window ID of the destination window. 
dest_x_return 
dest_y_return Returns the x and y coordinates within the destination window. 
display Specifies the connection to the X server. 
src_W Specifies the window ID of the source window. 
src_x 
src_y Specify the x and y coordinates within the source window. 
DESCRIPTION 


The XTranslateCoordinates function takes the src_x and src_y coordinates within the source window 
relative to the source window’s origin and returns these coordinates to dest_x_return and dest_y return 
relative to the destination window’s origin. If XTranslateCoordinates returns zero, src_w and dest_w are 
on different screens, and dest_x_return and dest_y return are zero. If the coordinates are contained ina 
mapped child of dest_w, that child is returned to the child argument. XTranslateCoordinates can gen- 


erate a Bad Window error. 
DIAGNOSTICS 

BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 


Xlib — C Language X Interface 
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NAME 
XUnmapWindow, XUnmapSubwindows — unmap windows 
SYNTAX 
XUnmapWindow(display, w) 
Display *display; 
Window w; 
XUnmapSubwindows( display, w) 
Display *display; 
Window w; 
OPTIONS 
display Specifies the connection to the X server. 
w Specifies the window ID. 
DESCRIPTION 


XUnmapWindow (3X ) 


The XUnmapWindow function unmaps the specified window and causes the X server to generate an 


UnmapNotify event. XUnmap Window can generate a BadWindow error. 


The XUnmapSubwindows function unmaps all subwindows for the specified window in bottom to top 
stacking order. It causes the X server to generate an UnmapNotify event on each subwindow and expo- 
sure events on formerly obscured windows. XUnmapSubwindows can generate a BadWindow error. 


DIAGNOSTICS 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 


XChangeWindowAttributes (3X), XConfigureWindow (3X), XCreateWindow (3X), XDestroyWin- 


dow (3X), XMapWindow (3X) XRaiseWindow (3X) 
Xlib — C Language X Interface 
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NAME 
XWarpPointer — control input focus 
SYNTAX 
XWarpPointer (display, src_w, dest_w, src_x, src_y, src_width, src_height, dest_x, 
dest_y) 
Display *display; 
Window src_w, dest_w; 
int src_x, STC_y; 
unsigned int src_width, src_height; 
int dest_x, dest_y; 
OPTIONS 
dest_w Specifies the window ID of the destination window. 
dest_x 
dest_y Specifies the x and y coordinates within the destination window. 
display Specifies the connection to the X server. 
src_width 
src_height Specifies the width and height of the source window. 
src_Ww Specifies the window ID of the source window. 
src_x 
src_y Specifies the x and y coordinates within the source window. 
DESCRIPTION 


The XWarpPointer function moves the pointer to the coordinates specified by the dest_x and dest_y argu- 
ments, relative to the destination window’s origin. If the destination window is None, the pointer is moved 
by offsets specified by the dest_x and dest_y coordinates. XWarpPointer can generate a BadWindow 


error. 
DIAGNOSTICS 

BadWindow __ A value for a window argument does not name a defined window. 
SEE ALSO 

XSetInputFocus(3X) 


Xlib — C Language X Interface 
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NAME 
XWindowEvent, XCheckWindowEvent, XMaskEvent, XCheckMaskEvent, XCheckTypedEvent, XCheck- 
TypedWindowEvent, XGetMotionEvents, XSendEvent — select event types 


SYNTAX 
XWindowEvent( display, w, event_mask, event_return) 
Display *display; 
Window w; 


long event_mask; 
XEvent *event_return; 


Bool XCheckWindowEvent (display, w, event_mask, event_return) 
Display *display; 
Window w; 
int event_mask; 
XEvent *event_return; 


XMaskEvent (display, event_mask, event_return) 
Display *display; . 
unsigned long event_mask; 

XEvent *event_return; 


Bool XCheckMaskEvent( display, event_mask, event_return) 
Display *display; 
unsigned long event_mask; 
XEvent *event_return; 


Bool XCheckTypedEvent (display, event_type, event_return) 
Display *display; 
int event_type; 
XEvent *event_return; 


Bool XCheckTypedWindowEvent (display, w, event_type , event_return) 
Display *display; 
Window w; 
int event_type; 
XEvent *event_return; 


XTimeCoord *XGetMotionEvents (display, w, start, stop, nevents_return) 
Display *display; 
Window w; 
Time start, stop; 
int *nevents_return; 


Status XSendEvent (display, w, propagate , event_mask, event_send) 
Display *display; 
Window w; 
Bool propagate ; 
unsigned long event_mask; 
XEvent *event_send; 


OPTIONS 
display Specifies the connection to the X server. 
event_mask Specifies the event mask. This mask is the bitwise inclusive OR of one or more of 
the valid event mask bits. 
event_return Copies the matched event’s associated structure into this client-supplied structure. 
event_send Specifies a pointer to the event that is to be sent. 
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event_type Specifies the event type to be compared. 

nevents_return Returns the number of events from the motion history buffer. 

propagate Specifies a boolean value that is either True or False. 

start 

stop Specifies the time interval in which the events are returned from the motion his- 


tory buffer. You can pass a time stamp, expressed in milliseconds, or Current- 
Time. If the stop time is in the future, it is equivalent to specifying CurrentTime. 


Ww Specifies the window ID. 


DESCRIPTION 
The XWindowEvent function searches the event queue for an event that matches both the specified win- 
dow and event mask. When it finds a match, XWindowEvent removes that event from the queue and 
copies it into the specified XEvent structure, 


The XCheck WindowEvent function searches the event queue, then the events available on the server con- 
nection, for the first event that matches the specified window and event mask. When it finds a match, 
XCheck WindowEvent removes that event, copies it into the specified XEvent structure, and returns True. 


The XMaskEvent function searches the event queue for the events associated with the specified mask. 
When it finds a match, XMaskEvent removes that and copies it into the specified XEvent structure. 


The XCheckMaskEvent function searches first the event queue, then any events available on the server 
connection, for the first event that matches the specified mask. When it finds a match, XCheckMaskEvent 
removes that event, copies it into the specified XEvent structure, and returns True. 


The XCheckTypedEvent function searches first the event queue, then any events available on the server 
connection, for the first event that matches the specified type. When it finds a match, XCheckTypedEvent 
returns its associated event structure to the specified XEvent structure and returns True. 


The XCheckTypedWindowEvent function searches first the event queue, then any events available on the 
server connection, for the first event that matches the specified type and window. When it finds a match, 
XCheckTypedWindowEvent removes the event from the queue, copies it into the specified XEvent struc- 
ture and returns True. 


The XGetMotionEvents function returns all events in the motion history buffer that fall between the 
specified start and stop times inclusive and that have coordinates that lie within (including borders) the 
specified window at its present placement. XGetMotionEvents can generate a BadWindow e error. 


The XSendEvent function sends an event to a specified window. XSendEvent can generate BadValue 
and BadWindow e errors. 


DIAGNOSTICS 
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a 
specific range is specified for an argument, the full range defined by the argument’s type 
is accepted. Any argument defined as a set of alternatives can generate this error. 


BadWindow __ A value for a window argument does not name a defined window. 


SEE ALSO 
Xlib — C Language X Interface 
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NAME 


XrmGetResource, XrmQGetResource, XrmQGetSearchList, XrmQGetSearchResource — retrieve database 
resources and search lists 


SYNTAX 


Bool XrmGetResource (database, str_name, str_class, str_type_return, value_return) 


XrmDatabase database; 
char *str_name; 

char *str_class; 

char **str_type_return; 
Xrm Value *value_return; 


Bool XrmQGetResource (database, quark_name, quark_class, quark_type_return, value_return) 


XrmDatabase database; 

XrmNameList quark_name; 
XrmClassList quark_class; 
XrmRepresentation *quark_type_return; 
Xrm Value *value_return; 


Bool XrmQGetSearchList (database, names, classes, list_return, list_length) 


Xrm Database database; 
XrmNameList names; 
XrmClassList classes; 
XrmSearchList list_return; 
int list length; 


Bool XrmQGetSearchResource (list, names, classes, type_return, value_return) 


XrmSearchList list; 

XrmName names; 

XrmClass classes; 
XrmRepresentation *type_return; 
Xrm Value *value_return; 


OPTIONS 
classes Specifies a list of resource classes. 
database Specifies the database that is to be used. 
list Specifies the search list returned by XrmQGetSearchList. 
list_length Specifies the number of entries (not the byte size) allocated for list_return. 
list_return Returns a search list for further use. 
str_class Specifies the fully qualified class of the value being retrieved (as a string). 
names Specifies a list of resource names. 
str_type_return Returns a pointer to the representation type of the destination (as a string). 
quark_class Specifies the fully qualified class of the value being retrieved (as a quark). 
quark_name Specifies the fully qualified name of the value being retrieved (as a quark). 
quark _type_return Returns a pointer to the representation type of the destination (as a quark). 
str_name Specifies the fully qualified name of the value being retrieved (as a string). 
value_return Returns the value in the database. 

DESCRIPTION 


The XrmGetResource and XrmQGetResource functions retrieve a resource from the specified database. 
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The XrmQGetSearchList function takes a list of names and classes and returns a list of database levels 
where a match might occur. 


The XrmQGetSearchResource function searches the specified database levels for the resource that is 
fully identified by the specified name and class. 


SEE ALSO 
Xrmfnitialize(3X), XrmMergeDatabases(3X), XrmPutResource(3X), XrmUniqueQuark(3X) 
Xlib — C Language X Interface 
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NAME 
Xrmlnitialize, XrmParseCommand — initialize the Resource Manager and parse the command line 


SYNTAX 
void Xrmlnitialize(); void XrmParseCommand (database, table, table_count, name, argc_return, 
argy_return,) 
XrmDatabase *database; 
XrmOptionDescList table ; 
int table_count; 
char *name; 
int *argc_return; 
char **argv_return; 


OPTIONS 
argc_return Contains the number of arguments before the call. After the call, returns the 
number of remaining arguments. 
argv_return Represents a pointer to the command line arguments before the call. After the 
call, matched arguments have been removed. 
database Specifies a pointer to the resource database. If database contains NULL, a new 
resource database is created and a pointer to it is returned in database. 
name 
table Specifies table of command line arguments to be parsed. 
table_count Specifies the number of entries in the table. 
DESCRIPTION 


The XrmInitialize function initializes the resource manager. The XrmParseCommand function parses an 
(arc, argv) pair according to the specified option table, loads recognized options into the specified database, 
and modifies the (arc, argv) pair to remove all recognized options. 


SEE ALSO 
XrmGetResource(3X), XrmMergeDatabases(3X), XrmPutResource(3X), XrmUniqueQuark(3X) 
Xlib — C Language X Interface 
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NAME 
XrmMergeDatabases, XrmGetFileDatabase, XrmPutFileDatabase, XrmGetStringDatabase — manipulate 
resource databases 


SYNTAX 
void XrmMergeDatabases(source_db, target_db) 
XrmDatabase source_db, *target_db; 


XrmDatabase XrmGetFileDatabase (filename) 
char *filename ; 


void XrmPutFileDatabase (database, stored_db) 
Xrm Database database; 
char *stored_db; 


XrmDatabase XrmGetString Database (data) 


char *data; 
OPTIONS 
data Specifies the database contents using a string. 
database Specifies the database that is to be used. 
filename Specifies the resource database file name. 
source_db Specifies the resource database that is to be merged into the target database. 
stored_db. Specifies the file name for the stored database. 
target_db Specifies a pointer to the resource database into which the source database is to be 
merged. 
DESCRIPTION 


The XrmMergeDatabases function merges the contents of one database into another. 


The XrmGetFileDatabase function opens the specified file, creates a new resource database, and loads it 
with the specifications read in from the specified file. 


The XrmPutFileDatabase function stores a copy of the application’s current database in the specified file. 


The XrmGetStringDatabase function creates a new database and stores the resources specified in the 
specified null-terminated string. 


SEE ALSO 
XrmGetResource(3X), XrmInitialize(3X), XrmPutResource(3X), XrmUniqueQuark(3X) 
Xlib — C Language X Interface 
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NAME 
XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPutStringResource, 
XrmPutLineResource — store database resources 
SYNTAX 
void XrmPutResource (database, specifier, type, value) 
XrmDatabase *database; 
char *specifier; 
char *type; 
Xrm Value *value; 
void XrmQPutResource (database, bindings, quarks, type, value) 
XrmDatabase *database; 
XrmBindingList bindings; 
XrmQuarkList quarks; 
XrmRepresentation type; 
Xrm Value *value; 
void XrmPutStringResource (database, resource, value) 
Xrm Database *database; 
char *resource; 
char *value; 
void XrmQPutStringResource (database, bindings, quarks, value) 
Xrm Database *database; 
XrmBindingList bindings; 
XrmQuarkList quarks; 
char *value; 
void XrmPutLineResource (database, line) 
Xrm Database *database; 
char *line; 
OPTIONS 
bindings Specifies a list of bindings. 
database Specifies a pointer to the resource database. If database contains NULL, a new 
resource database is created and a pointer to it is returned in database. 
line Specifies the resource value pair as a single string. A single colon (‘‘:’’) separates 
the name from the value. 
quarks Specifies the partial name or class list of the resource to be stored. 
resource Specifies the resource as a string. 
specifier Specifies a partial specification of the resource. 
type Specifies the type of the resource. 
value Specifies the value of the resource. 
DESCRIPTION 
The XrmPutResource and XrmQPutResource functions store a resource specification into the specified 
database. 


XrmPutStringResource adds a resource with the specified value to the specified database. 


The XrmQPutStringResource function adds a string resource to the specified database using quarks as 
the specification. — 
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XrmPutLineResource adds a single resource entry to the specified database. 


SEE ALSO 
XrmGetResource(3X), XrmInitialize(3X), XrmMergeDatabases(3X), XrmUniqueQuark(3X) 
Xlib — C Language X Interface 
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NAME 
XrmUniqueQuark, XrmStringToQuark, XrmQuarkToString, XrmStringToQuarkList, XrmStringToBin- 
dingQuarkList — manipulate resource quarks 


SYNTAX 
XrmQuark XrmUniqueQuark() 


#define XrmStringToName(string) XrmStringToQuark(string) 
#define XrmStringToClass(string) XrmStringToQuark(string) 
#define XrmStringToRepresentation(string) XrmStringToQuark(string) 


XrmQuark XrmStringToQuark (string) 

char *string; 
#define XrmNameToString(name) XrmQuarkToString(name) 
#define XrmClassToString(class) XrmQuarkToString(class) - 
#define XrmRepresentationToString(type) XrmQuarkToString(type) 


char *XrmQuarkToString (quark) 
XrmQuark quark; 


#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (mame)) 
#define XrmStringToClassList(str,class) XrmStringToQuark List((str), (class)) 


void XrmStringToQuarkList (string, quarks_return) 
char *string; 
XrmQuarkList quarks_return; 
XrmStringToBindingQuarkList (string, bindings_return, quarks_return) 
char *string; 
XrmBindingList bindings return; 
ArmQuarkList quarks_return; 


OPTIONS 
bindings return Returns the binding list. 
quark Specifies the quark for which the equivalence string is desired. 
quark_return Returns the list of quarks. 
string Specifies the string for which a quark is to be allocated. 
DESCRIPTION 


The XrmUniqueQuark function allocates a quark that is guaranteed not to represent any string. 
The XrmStringToQuark function converts the specified string to a resource quark representation. 
The XrmQuarkToString function converts the specified resource quark representation back to a string. 


The XrmStringToQuarkList function converts the null terminated ia: (generally a fully qualified 
name) to alist of quarks. The components of the string are separated by a **.”’ character. 


The Rene tong onde dueret et function converts the specified string to a binding list and a quark 
list. 


SEE ALSO 
XrmGetResource(3X), XrmInitialize(3X), XrmMergeDatabases(3X), Xrm PutResource(3X) 
Xlib — C Language X Interface 
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